MyBatis-Plus中使用Mockito测试Service层时解决空指针问题

问题背景

在使用MyBatis-Plus框架开发项目时，我们经常会遇到需要对Service层进行单元测试的情况。MyBatis-Plus提供的ServiceImpl基类为我们封装了大量常用CRUD操作，但在使用Mockito框架进行单元测试时，可能会遇到空指针异常问题。

问题现象

当尝试对继承自ServiceImpl的自定义Service类进行单元测试时，如果直接使用@Mock注解模拟Mapper接口，并通过@InjectMocks注入Service实现类，运行时会出现空指针异常。这是因为ServiceImpl基类中的baseMapper字段没有被正确初始化。

问题分析

MyBatis-Plus的ServiceImpl基类内部维护了一个baseMapper字段，这个字段通常由Spring容器在运行时通过依赖注入完成初始化。但在单元测试环境中，当我们使用Mockito框架时，这个注入过程不会自动发生，导致baseMapper为null。

解决方案

方案一：反射设置baseMapper字段

@BeforeEach
void setUp() {
    try {
        Field baseMapperField = ServiceImpl.class.getDeclaredField("baseMapper");
        baseMapperField.setAccessible(true);
        baseMapperField.set(myServiceImpl, myDao);
    } catch (NoSuchFieldException | IllegalAccessException e) {
        e.printStackTrace();
    }
}

这种方法通过反射直接设置ServiceImpl的私有字段，虽然有效但不够优雅，且依赖于实现细节。

方案二：Mock getBaseMapper()方法

更优雅的方式是使用Mockito的doReturn方法来模拟getBaseMapper()的行为：

doReturn(baseMapper).when(myServiceImpl).getBaseMapper();

这种方法更加符合面向对象的设计原则，不依赖于实现细节，只关注公开接口。

最佳实践建议

1. 封装测试工具类：可以将baseMapper的设置逻辑封装到一个测试工具类中，避免重复代码。

2. 考虑使用SpringBootTest：对于复杂的Service测试，可以考虑使用@SpringBootTest注解，结合MockBean来模拟依赖。

3. 保持测试独立性：确保每个测试方法都是独立的，避免测试间的相互影响。

4. 合理使用Mock：只Mock必要的依赖，保持测试的真实性。

总结

在MyBatis-Plus项目中进行Service层单元测试时，正确处理baseMapper的初始化是关键。通过本文介绍的两种方法，开发者可以有效地解决测试中的空指针问题。推荐优先使用第二种方法，它更加符合面向对象的设计原则，代码也更加清晰可维护。