JUnit单元测试报错：Spring动态代理导致Bean类型不匹配怎么办？

Spring单元测试失败：动态代理导致Bean类型不匹配

在使用JUnit进行Spring单元测试时，经常会遇到BeanNotOfRequiredTypeException异常，提示注入的Bean类型与预期类型不符，实际类型通常是一个动态代理类。这通常是因为Spring AOP或其他字节码增强技术导致的。

错误信息示例：

<code>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'</code>

原因分析：

Spring AOP会在运行时为被代理的Bean创建代理对象，以织入横切关注点（例如事务管理、日志记录等）。 如果你的单元测试直接依赖于被AOP代理的Bean，而没有考虑代理的存在，就会出现类型不匹配的问题。

解决方案：

小羊标书

一键生成百页标书，让投标更简单高效

下载

1. 使用@MockBean或@Mock模拟Bean: 这是推荐的解决方法，特别是对于集成测试。 使用Mockito或Spring的@MockBean注解模拟CustomerApiToSF Bean，这样测试就不会依赖于实际的Bean实现以及其动态代理。

   <code class="java">@SpringBootTest
   class MyControllerTest {
   
       @MockBean
       private CustomerApiToSF customerApiToSF;
   
       @Autowired
       private MyController myController;
   
       // ... your test methods ...
   }</code>

2. 在测试配置中禁用AOP: 如果必须使用真实的Bean，可以在测试配置中禁用AOP。这通常不推荐，因为它会绕过AOP的功能，可能导致测试结果不准确。 如果采用此方法，需要在测试配置类上添加@EnableAspectJAutoProxy(proxyTargetClass = false)注解来禁用基于类的代理，或者使用@Primary注解指定一个非代理的Bean。

3. 使用反射获取目标对象: 这是一种比较复杂且不推荐的方法。可以通过反射获取代理对象的底层目标对象，但这会增加测试代码的复杂度，并且依赖于具体的代理实现，不易维护。

   <code class="java">// 不推荐使用这种方法
   Object handler = Proxy.getInvocationHandler(customerApiToSF);
   CustomerApiToSF realCustomerApiToSF = (CustomerApiToSF) handler; </code>

总结：

使用@MockBean或@Mock模拟Bean是解决Spring单元测试中动态代理问题最简洁、高效且推荐的方法。 它能确保测试的独立性，避免依赖于复杂的Spring上下文和AOP配置。 只有在极少数情况下，才考虑其他方法，并且需要仔细权衡其利弊。