带@Autowired依赖的MapStruct转换器在Mockito单元测试中为何失效?
单测失效原因排查与修复方案
核心问题定位
线上业务逻辑正常但单测返回null,本质是测试环境的实例获取逻辑和MapStruct的Spring组件模式不兼容,具体问题如下:
- MapStruct在
@Mapper(componentModel = "spring")模式下,编译生成的MyConverterImpl完全依赖Spring容器完成依赖注入:生产环境下Spring会自动将TimeUtils实例注入到类中被@Autowired标记的timeUtils字段,因此运行逻辑正常。 - 单测环境下,你通过
Mappers.getMapper()直接创建MapStruct实现类的实例,该实例是通过无参构造直接生成的,全程没有经过Spring容器的依赖注入流程,类内部的timeUtils字段实际为null。 - 你虽然用了
@InjectMocks注解,但两个问题导致mock对象根本没注入到目标实例里:- 测试代码里类名拼写错误:把
MyConverter写成了MyConverte,Mockito找不到匹配的实例字段做注入 - MapStruct生成的实现类对
timeUtils采用字段注入策略,Mockito默认的@InjectMocks优先级是构造方法注入 > Setter注入 > 字段注入,对protected字段的注入经常不生效
- 测试代码里类名拼写错误:把
- 当
convert方法执行时,因为内部timeUtils为null,表达式执行失败,expiryDate字段就被赋值为null。
可落地的修改方案
- 不要在Spring组件模式下用
Mappers.getMapper()获取MapStruct实例,这种方式本质是MapStruct默认组件模式下的实例获取逻辑,和Spring的注入机制不兼容。 - 单测里直接实例化MapStruct生成的实现类,手动给
timeUtils字段赋值mock对象,示例代码:
@RunWith(MockitoJUnitRunner.class) public class MyConverterTest { private MyConverter myConverter; @Mock private TimeUtils timeUtils; @Before void setup() { // 直接实例化编译期生成的MapStruct实现类 myConverter = new MyConverterImpl(); // 手动给protected的timeUtils字段注入mock实例 myConverter.timeUtils = timeUtils; } @Test void convertPeriodToDate_ok() { // 构造测试数据 final Subscription subscription = Subscription.Builder .id(1) .period("P2Y") .build(); final LocalDate expectedExpiryDate = LocalDate.now().plusYears(2); // 配置mock返回规则 when(timeUtils.toDate("P2Y")).thenReturn(expectedExpiryDate); // 执行转换逻辑 final SubscriptionPo subscriptionPo = myConverter.convert(subscription); // 断言结果 assertNotNull(subscriptionPo); assertEquals(1, subscriptionPo.getId()); assertEquals(expectedExpiryDate, subscriptionPo.getExpiryDate()); } }
如果你希望沿用
@InjectMocks的自动注入逻辑,可以把抽象类里的字段注入改成Setter注入,MapStruct会自动适配:@Mapper(componentModel = "spring") public abstract class MyConverter { protected TimeUtils timeUtils; @Autowired public void setTimeUtils(TimeUtils timeUtils) { this.timeUtils = timeUtils; } // 映射方法保持原有逻辑不变 }
另外需要修正原代码里的几处语法错误,否则代码根本无法编译通过:
@Mapping注解内的expression字符串缺少双引号转义,会导致MapStruct解析表达式失败convert方法的参数列表括号缺失Subscription.Builder的build()方法缺少括号- 测试代码里
new TimeUtils.toDate(...)属于语法错误,new关键字后必须接构造方法 when(...)语句的返回值部分括号缺失
内容的提问来源于stack exchange,提问作者j3d
相关产品推荐
相关产品推荐

