### @MapperScan 注解的使用方法 #### 1. **@MapperScan 基本功能** `@MapperScan` 是 MyBatis-Spring 提供的一个注解，用于扫描指定包下的 Mapper 接口，并将它们注册为 Spring 容器中的 Bean。这使得开发者能够更方便地管理 Mapper 接口，而不需要手动声明每个接口[^4]。 --- #### 2. **配置扫描 platform 包下的所有 Mapper 接口** 若要扫描 `platform` 包及其子包下的所有 Mapper 接口，可以在 Spring Boot 应用程序的启动类或其他配置类上添加如下代码： ```java @SpringBootApplication @MapperScan("com.htsc.fst.eam.platform.mapper") public class PlatformApplication { public static void main(String[] args) { SpringApplication.run(PlatformApplication.class, args); } } ``` 上述代码中，`@MapperScan("com.htsc.fst.eam.platform.mapper")` 表示扫描 `com.htsc.fst.eam.platform.mapper` 及其子包下的所有 Mapper 接口，并将其注册到 Spring 容器中[^5]。 --- #### 3. **支持多种方式的 Mapper 扫描** ##### 方法一：单个包路径扫描 如果只需要扫描单一包路径下的 Mapper 接口，可以直接在 `@MapperScan` 中传入对应的包路径字符串： ```java @MapperScan("com.htsc.fst.eam.platform.mapper") ``` ##### 方法二：多个包路径扫描 支持通过数组形式传递多个包路径，从而一次性扫描多个目录下的 Mapper 接口： ```java @MapperScan({"com.htsc.fst.eam.platform.mapper", "com.another.package.mapper"}) ``` ##### 方法三：结合 YAML 配置文件 在某些场景下，可能希望通过外部配置文件动态设置 Mapper 的扫描路径。例如，在 `application.yml` 或 `application.properties` 文件中定义扫描路径： ```yaml mybatis: mapper-locations: classpath:mapper/**/*.xml type-aliases-package: com.htsc.fst.eam.platform.entity ``` 同时，仍然需要在 Java 配置类中使用 `@MapperScan` 来指定接口所在的包路径[^2]。 --- #### 4. **注意事项** - **命名空间匹配** 当使用 XML 形式的 Mapper 配置时，确保 XML 文件中的 `<mapper>` 标签的 `namespace` 属性与对应接口的全限定名一致。例如： ```xml <mapper namespace="com.htsc.fst.eam.platform.mapper.UserMapper"> <!-- SQL statements --> </mapper> ``` 这样可以保证 MyBatis 能够正确关联 Mapper 接口与其对应的 XML 文件[^1]。 - **依赖注入检查** 确保 Mapper 接口已被成功加载到 Spring 容器中后，可以通过 `@Autowired` 注解完成依赖注入操作。如果发现注入失败，请检查以下几点： - 是否正确指定了扫描路径。 - Mapper 接口中是否存在语法错误或未实现的方法签名。 - 是否遗漏了必要的 MyBatis 和 Spring 整合依赖项[^5]。 --- ### 总结 使用 `@MapperScan` 注解可以高效地扫描并注册指定包下的所有 Mapper 接口。无论是单独配置还是结合 YAML 文件共同作用，都应确保路径准确性以及相关组件间的协调配合。 ---