单元测试注入mapper为空

### 解决 Spring Boot 单元测试中 MyBatis Mapper 对象为空的问题 在 Spring Boot 中进行单元测试时，如果发现 MyBatis 的 Mapper 对象注入为空，通常是因为测试环境未能正确加载 MyBatis 的配置或未正确初始化 Mapper Bean。以下是解决问题的完整方法： --- #### 1. 确保测试类使用了正确的注解 测试类需要使用 `@SpringBootTest` 注解来确保测试运行在 Spring Boot 的上下文中[^2]。此外，为了更高效地加载与 MyBatis 相关的配置，可以结合使用 `@AutoConfigureTestDatabase` 和 `@Transactional` 注解。 ```java @SpringBootTest @AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE) @Transactional public class UserMapperTest { @Autowired private UserMapper userMapper; @Test void getUserById() { assertNotNull(userMapper); // 确保 Mapper 不为空 UserEntity user = userMapper.getUserById(1); System.out.println(user); } } ``` --- #### 2. 检查 MyBatis 配置是否正确 确保 `application.yml` 或 `application.properties` 文件中正确配置了 MyBatis 的相关参数。例如： ```yaml mybatis: type-aliases-package: com.example.demo.entity mapper-locations: classpath:mapper/*.xml ``` 如果配置错误或路径不匹配，可能导致 Mapper 无法被正确扫描和注册为 Bean[^1]。 --- #### 3. 使用 `@MapperScan` 手动扫描 Mapper 接口 如果 MyBatis 的 Mapper 接口未被自动扫描到，可以在主应用类或配置类上添加 `@MapperScan` 注解，指定 Mapper 接口所在的包路径。 ```java @SpringBootApplication @MapperScan("com.example.demo.mapper") public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } } ``` --- #### 4. 替换 `@Autowired` 为 `@Resource` 如果仍然遇到 Mapper 注入失败的问题，可以尝试将 `@Autowired` 替换为 `@Resource` 注解。`@Resource` 默认按名称装配，若未找到匹配名称则按类型装配，这可能解决某些情况下注入失败的问题[^3]。 ```java @Resource private UserMapper userMapper; ``` --- #### 5. 检查 IDEA 缓存问题 有时 IDE 缓存可能导致 Mapper 注入失败的假象。可以通过以下步骤清理缓存并重新加载项目： - 在 IntelliJ IDEA 中，选择 `File -> Invalidate Caches / Restart`。 - 清理 Maven 或 Gradle 缓存后重新构建项目。 --- #### 6. 使用 Mock 方法替代实际数据库操作 如果不想依赖实际数据库，可以使用 Mockito 模拟 Mapper 行为。 ```java @ExtendWith(MockitoExtension.class) public class UserMapperMockTest { @Mock private UserMapper userMapper; @Test void testGetUserById() { UserEntity mockUser = new UserEntity(); mockUser.setId(1); mockUser.setName("TestUser"); when(userMapper.getUserById(1)).thenReturn(mockUser); UserEntity result = userMapper.getUserById(1); assertNotNull(result); assertEquals("TestUser", result.getName()); } } ``` --- #### 注意事项 - 如果 Mapper 接口未被正确扫描或注册为 Bean，可能是由于包路径配置错误或未启用 `@MapperScan` 注解。 - 测试环境中应确保数据库连接正常，否则可能导致 Mapper 方法调用失败。 - 使用 `@Transactional` 注解可以避免测试对实际数据的影响。 --- ### 示例代码总结 以下是一个完整的测试类示例： ```java @SpringBootTest @AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE) @Transactional public class UserMapperTest { @Autowired private UserMapper userMapper; @Test void testGetUserById() { assertNotNull(userMapper); // 确保 Mapper 不为空 UserEntity user = userMapper.getUserById(1); assertNotNull(user); System.out.println(user); } } ``` ---