使用配置时MapStruct Mapper在测试中抛出空指针异常排查

问题根源 #

你的ResponseMappingConfig指定了componentModel = SPRING，这意味着MapStruct会生成Spring管理的Bean，依赖的ResponseMapper会通过Spring的依赖注入机制赋值。但测试中你使用了Mappers.getMapper(ResponseCreationMapper.class)——这是MapStruct的默认实例化方式，完全不依赖Spring容器，因此生成的Mapper实例里responseMapper字段不会被赋值，调用方法时直接抛出空指针异常。

移除配置后，componentModel默认是default模式，MapStruct会自动实例化依赖的ResponseMapper，所以测试能正常运行。

解决方案 #

方案1：测试中使用Spring容器获取Mapper（推荐）

既然使用了Spring组件模型，测试就应该遵循Spring的Bean管理逻辑：

1. 给测试类添加Spring测试注解，启动Spring上下文：

@SpringBootTest
class ResponseCreationMapperTest {

    @Autowired
    private ResponseCreationMapper mapper;

    @Test
    void assertWarningsAndErrorsAreMapped() {
        var response = mapper.asCreateClaimResponse(createResponse());
        assertThat(.............);
    }
}

2. 确保ResponseMapper也是Spring管理的Bean，修改它的注解：

@Mapper(componentModel = MappingConstants.ComponentModel.SPRING)
public class ResponseMapper {
    // 原有映射方法不变
}

这样Spring会自动将ResponseMapper实例注入到ResponseCreationMapper中，彻底解决空指针问题。

方案2：拆分配置，测试用默认组件模型

如果不想在测试中启动Spring容器，可以针对测试环境单独配置：

1. 创建测试专用的Mapper配置（去掉Spring组件模型）：

@MapperConfig(uses = { ResponseMapper.class })
public interface TestResponseMappingConfig {
}

2. 测试时使用该配置的Mapper（可通过创建测试专用Mapper类或Profile切换实现），此时Mappers.getMapper()会自动实例化依赖的ResponseMapper。

方案3：手动注入依赖（不推荐）

若坚持使用Mappers.getMapper()，可手动给生成的Mapper实例设置依赖：

class ResponseCreationMapperTest {

    @Test
    void assertWarningsAndErrorsAreMapped() {
        ResponseCreationMapper mapper = Mappers.getMapper(ResponseCreationMapper.class);
        // 强制转换为MapStruct生成的实现类，手动注入依赖
        ((ResponseCreationMapperImpl) mapper).setResponseMapper(new ResponseMapper());
        var response = mapper.asCreateClaimResponse(createResponse());
        assertThat(.............);
    }
}

注意：此方式耦合度高，依赖MapStruct生成的实现类命名规则，仅适合临时调试。

内容的提问来源于stack exchange，提问作者JavaIsNotBoring