Spring中含JPA依赖的MapStruct单元测试：@MockBean为何生效？

为什么@Mock + @InjectMocks + @Autowired不生效？ #

• 抽象类无法被Mockito实例化：ExchangeRateMapper是抽象类，@InjectMocks的核心逻辑是Mockito尝试创建目标类的实例（通过无参构造、反射等方式），但抽象类不能直接实例化，Mockito没法生成它的实例。同时，纯Mockito测试（未添加@SpringBootTest这类加载Spring上下文的注解）不会启动Spring容器，@Autowired根本找不到ExchangeRateMapperImpl的实例，最终拿到的是null，导致测试报错。
• MapStruct实现类的特殊性：ExchangeRateMapperImpl是编译时自动生成的Spring组件（默认MapStruct的Spring模式会给实现类加@Component注解），但纯Mockito测试不加载Spring上下文，这个实现类不会被Spring管理，自然也不会被实例化注入到测试类中。

为什么@MockBean能正常运行？ #

• @MockBean是Spring Boot Test提供的注解，它会触发Spring上下文的加载，同时把你mock的CurrencyRepository替换掉上下文里的真实Bean。
• 上下文加载后，Spring会自动扫描并实例化MapStruct生成的ExchangeRateMapperImpl（因为它带有@Component注解），并把mock的CurrencyRepository注入到这个实现类中，所以你直接用@Autowired就能拿到可用的Mapper实例，测试自然能正常运行。

这种做法符合单元测试最佳实践吗？ #

• 严格来说，用@MockBean加载Spring上下文的方式属于集成测试范畴，并非纯单元测试。纯单元测试应尽量避免加载Spring上下文——启动上下文会增加测试耗时，且测试边界更宽泛（不仅测试Mapper的转换逻辑，还涉及Spring的注入机制）。
• 更符合单元测试最佳实践的做法：
  1. 直接使用MapStruct生成的ExchangeRateMapperImpl类，手动创建实例并注入mock：

     @ExtendWith(MockitoExtension.class)
     public class ExchangeRateMapperTest {
         @Mock
         private CurrencyRepository currencyRepository;
     
         private ExchangeRateMapper mapper;
     
         @BeforeEach
         void setUp() {
             mapper = new ExchangeRateMapperImpl();
             // 用反射工具类注入mock的Repository
             ReflectionTestUtils.setField(mapper, "currencyRepository", currencyRepository);
         }
     
         // 测试方法...
     }
     

  2. 若MapStruct配置了componentModel = "spring"，也可以直接指定实现类配合@InjectMocks：

     @ExtendWith(MockitoExtension.class)
     public class ExchangeRateMapperTest {
         @Mock
         private CurrencyRepository currencyRepository;
     
         @InjectMocks
         private ExchangeRateMapperImpl mapper;
     
         // 测试方法...
     }
     

  这两种方式都无需加载Spring上下文，属于纯单元测试，测试速度更快，边界更清晰，只聚焦于Mapper本身的转换逻辑。

内容的提问来源于stack exchange，提问作者V. Gluhih