单元测试注入mapper失败

### 解决单元测试中注入 Mapper 失败的问题 在 Spring Boot 单元测试中，如果发现 `@Autowired` 注解无法正确注入 Mapper 对象，通常是因为以下原因导致的： 1. **Mapper 扫描路径未配置**：Spring Boot 项目中，Mapper 接口需要被正确扫描到并注册为 Bean。如果没有正确配置扫描路径，Spring 容器将无法识别这些 Mapper 接口。 2. **缺少 MyBatis 相关依赖或配置**：确保项目中引入了 MyBatis 和 MyBatis-Spring-Boot-Starter 的相关依赖，并且正确配置了 MyBatis 的环境。 3. **测试类未启用组件扫描**：在测试类中，必须通过注解明确指定组件扫描范围，或者直接启用 MyBatis 的 Mapper 扫描功能。 以下是解决该问题的具体方法： #### 方法一：确保 Mapper 被正确扫描 在主应用类或测试类中，使用 `@MapperScan` 注解指定 Mapper 接口所在的包路径[^1]： ```java @MapperScan("com.example.mapper") @SpringBootTest public class ServiceTest { @Autowired private TestMapper testMapper; @Test void testMapperInjection() { assertNotNull(testMapper); // 确保 Mapper 不为空 } } ``` #### 方法二：检查 MyBatis 配置是否完整 确保 `application.yml` 或 `application.properties` 中正确配置了 MyBatis 的相关内容[^2]： ```yaml mybatis: mapper-locations: classpath:mapper/*.xml # 指定 Mapper XML 文件的位置 type-aliases-package: com.example.model # 指定实体类所在包 ``` #### 方法三：启用自动配置 在测试类中，添加 `@AutoConfigureMockMvc` 或其他必要的自动配置注解，以确保测试环境能够正确加载所有 Bean[^3]： ```java @SpringBootTest @AutoConfigureMockMvc public class ServiceTest { @Autowired private TestMapper testMapper; @Test void testMapperInjection() { assertNotNull(testMapper); // 确保 Mapper 不为空 } } ``` #### 方法四：检查依赖是否正确引入 确保项目的 `pom.xml` 或 `build.gradle` 中包含以下依赖项： ```xml <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>2.3.1</version> </dependency> ``` #### 方法五：使用 `@ContextConfiguration` 明确指定上下文 如果上述方法仍然无效，可以尝试使用 `@ContextConfiguration` 注解，明确指定上下文配置类[^3]： ```java @SpringBootTest @ContextConfiguration(classes = {MyApplication.class, MyBatisConfig.class}) public class ServiceTest { @Autowired private TestMapper testMapper; @Test void testMapperInjection() { assertNotNull(testMapper); // 确保 Mapper 不为空 } } ``` ### 注意事项 - 如果测试类中仅需要验证 Mapper 的行为，而不需要启动整个 Spring 应用上下文，可以考虑使用 `@DataJpaTest` 或 `@Sql` 注解来简化测试。 - 在某些情况下，可能需要手动创建 Mapper Bean 并注入到测试类中。这可以通过 `@Before` 方法实现。 ---