本文介绍在 Spring 环境下对含依赖子映射器（如 SpouseDetailMapper）的 MapStruct 接口（如 StudentDetailMapper）进行单元测试的可靠方案，核心是通过 @Spy + @InjectMocks 配合 ReflectionTestUtils.setField() 手动注入子映射器实例，避免 NPE。

本文介绍在 spring 环境下对含依赖子映射器（如 `spousedetailmapper`）的 mapstruct 接口（如 `studentdetailmapper`）进行单元测试的可靠方案，核心是通过 `@spy` + `@injectmocks` 配合 `reflectiontestutils.setfield()` 手动注入子映射器实例，避免 npe。

MapStruct 在启用 componentModel = "spring" 且声明 uses = SpouseDetailMapper.class 时，会将子映射器作为私有字段（如 private SpouseDetailMapper spouseDetailMapper;）注入到生成的实现类中。但在纯单元测试环境下（无 Spring 容器），Mappers.getMapper() 创建的代理对象不会自动初始化 uses 所依赖的子映射器字段——该字段保持为 null，导致调用时抛出 NullPointerException。

标准 @Spy 仅对目标 mapper 本身进行部分模拟，无法自动处理其内部依赖链。因此，必须显式为子映射器创建可工作的 spy 实例，并通过反射将其注入父映射器的对应字段。

✅ 正确做法如下：

1. 为所有涉及的映射器声明 @Spy（包括主映射器和所有 uses 中的子映射器）；
2. 对子映射器额外添加 @InjectMocks（确保 Mockito 尝试为其注入其自身依赖，虽此处无依赖，但有助于统一管理）；
3. 在 @BeforeEach 中使用 ReflectionTestUtils.setField() 手动绑定，将子映射器实例注入父映射器的私有字段（字段名需与 MapStruct 生成代码中的实际字段名一致，通常为小驼峰命名，如 spouseDetailMapper）。

示例代码：

@ExtendWith(MockitoExtension.class)
class StudentDetailServiceTest {

    @Spy
    private StudentDetailMapper studentDetailMapper = Mappers.getMapper(StudentDetailMapper.class);

    @Spy
    @InjectMocks
    private SpouseDetailMapper spouseDetailMapper = Mappers.getMapper(SpouseDetailMapper.class);

    @Mock
    private StudentDetailRepository studentDetailRepository;

    @InjectMocks
    private StudentDetailService studentDetailService;

    @BeforeEach
    void setUp() {
        // 关键：手动注入子映射器实例
        ReflectionTestUtils.setField(
            studentDetailMapper,
            "spouseDetailMapper",  // 字段名必须与生成类中一致
            spouseDetailMapper
        );
    }

    @Test
    void getStudentDetail() {
        // 准备测试数据
        StudentDetail studentDetail = createTestStudentDetail();
        StudentDetailDTO expectedDTO = createExpectedDTO();

        // Stub 子映射器行为（可选，若子映射逻辑复杂需验证）
        when(spouseDetailMapper.toDTO(any())).thenReturn(createSpouseDTO());

        // Stub 主映射器行为（或直接依赖其真实逻辑）
        when(studentDetailMapper.toDTO(any())).thenReturn(expectedDTO);

        // Stub Repository
        when(studentDetailRepository.findByStudentStudentID(anyString()))
            .thenReturn(Optional.of(studentDetail));

        // 执行
        StudentDetailDTO result = studentDetailService.getStudentDetail("STU-001");

        // 断言
        assertThat(result).isEqualTo(expectedDTO);
    }
}

⚠️ 注意事项：

• 字段名必须准确：MapStruct 生成的实现类中子映射器字段名默认为接口类名的首字母小写形式（如 SpouseDetailMapper → spouseDetailMapper）。可通过反编译生成的 StudentDetailMapperImpl 类确认；
• 避免重复 @Spy 初始化：不要同时使用 Mappers.getMapper() 和 @Autowired（后者需 Spring 上下文），本方案适用于纯 Mockito 测试；
• @InjectMocks 对子映射器的作用：虽 SpouseDetailMapper 本身无依赖，但标注 @InjectMocks 可确保 Mockito 将其纳入 mock 管理范围，便于后续 stub；
• 若子映射器本身也依赖其他 mapper，需按相同模式逐层注入。

此方案无需引入 Spring TestContext，轻量、可控、符合单元测试隔离原则，是解决 MapStruct 子映射器 NPE 问题的推荐实践。