You need to enable JavaScript to run this app. 带@Autowired依赖的MapStruct转换器在Mockito单元测试中为何失效?
优惠活动
大模型
产品
解决方案
定价
更多

带@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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 09:27:03