Spring单元测试失败：动态代理导致Bean类型不匹配
在使用JUnit进行Spring单元测试时，经常会遇到BeanNotOfRequiredTypeException异常，提示注入的Bean类型与预期类型不符，实际类型通常是一个动态代理类。这通常是因为Spring AOP或其他字节码增强技术导致的。
错误信息示例：
org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'myController': Unsatisfied dependency expressed through field 'myService'; nested exception is org.springframework.beans.factory.BeanNotOfRequiredTypeException: Bean named 'myService' is expected to be of type 'com.example.MyService' but was actually of type 'com.sun.proxy.$Proxy123'
原因分析：
Spring AOP会在运行时为被代理的Bean创建代理对象，以织入横切关注点（例如事务管理、日志记录等）。 如果你的单元测试直接依赖于被AOP代理的Bean，而没有考虑代理的存在，就会出现类型不匹配的问题。
解决方案：
-
使用
@MockBean或@Mock模拟Bean: 这是推荐的解决方法，特别是对于集成测试。 使用Mockito或Spring的@MockBean注解模拟CustomerApiToSFBean，这样测试就不会依赖于实际的Bean实现以及其动态代理。@SpringBootTest class MyControllerTest { @MockBean private CustomerApiToSF customerApiToSF; @Autowired private MyController myController; // ... your test methods ... } -
在测试配置中禁用AOP: 如果必须使用真实的Bean，可以在测试配置中禁用AOP。这通常不推荐，因为它会绕过AOP的功能，可能导致测试结果不准确。 如果采用此方法，需要在测试配置类上添加
@EnableAspectJAutoProxy(proxyTargetClass = false)注解来禁用基于类的代理，或者使用@Primary注解指定一个非代理的Bean。 -
使用反射获取目标对象: 这是一种比较复杂且不推荐的方法。可以通过反射获取代理对象的底层目标对象，但这会增加测试代码的复杂度，并且依赖于具体的代理实现，不易维护。
// 不推荐使用这种方法 Object handler = Proxy.getInvocationHandler(customerApiToSF); CustomerApiToSF realCustomerApiToSF = (CustomerApiToSF) handler;
总结：
使用@MockBean或@Mock模拟Bean是解决Spring单元测试中动态代理问题最简洁、高效且推荐的方法。 它能确保测试的独立性，避免依赖于复杂的Spring上下文和AOP配置。 只有在极少数情况下，才考虑其他方法，并且需要仔细权衡其利弊。
