找不到对应的Mapper，原来是@MapperScan注解的basePackages

<think>嗯，用户的问题是使用MyBatis时，即使添加了@Mapper注解，仍然无法找到bwan的问题。首先，我需要确定用户的具体情况。可能的问题点有很多，比如扫描配置、路径设置、依赖冲突等。根据提供的引用内容，用户可能遇到了Mapper接口没有被正确扫描到的情况。 首先，根据引用[3]，启动类的位置可能会影响自动扫描。如果启动类不在根包下，可能需要手动配置扫描路径。用户是否更改了启动类的位置？如果是的话，可能需要添加@MapperScan注解来指定包路径。 然后，检查MyBatis或MyBatis-Plus的配置。引用[1]提到，需要确认mapper-locations是否正确配置了XML文件的路径，并且接口方法与XML中的定义是否一致。如果用户使用的是MyBatis，可能需要将mybatis-plus改为mybatis，并检查路径是否正确。 另外，版本兼容性也是一个问题。引用[5]指出，版本不匹配可能导致注解失效，比如Spring Boot和Cloud的版本不兼容。用户可能需要检查依赖版本，确保MyBatis和相关库的版本一致。 还有，接口和XML的对应关系是否正确？引用[1]和[2]都强调了方法名和参数需要一致，特别是使用@Param注解的情况。用户是否在接口方法中正确使用了参数注解？ 此外，XML文件是否被正确打包到项目中？有时候Maven可能没有将resources目录下的文件正确包含进去，导致运行时找不到XML映射文件。 还有可能，用户是否同时使用了@Repository和@Mapper？根据引用[1]，@Mapper已经足够，但如果有其他配置问题，可能需要排除其他干扰因素。 最后，用户提到的“bwan”可能是一个拼写错误，或者是某个特定的Mapper接口名称？需要确认是否存在拼写错误，或者包结构是否正确，导致扫描不到。 总结下来，需要逐步检查启动类位置、扫描配置、XML路径、版本兼容性、方法签名一致性、XML文件打包情况，以及可能的拼写错误或包结构问题。这样才能全面排查@Mapper注解未生效的原因。</think>### MyBatis @Mapper 注解生效条件及排查步骤 #### 一、@Mapper 注解生效条件 1. **包扫描配置正确** - 若未使用 `@MapperScan` 注解显式指定扫描路径，则 `@Mapper` 接口必须位于 **Spring Boot 启动类同级或子级包**中[^3] - 若启动类位置变更，需手动添加 `@MapperScan(basePackages = "mapper接口所在包")` 2. **MyBatis 配置正确** ```yaml mybatis: mapper-locations: classpath:mapper/*.xml # XML映射文件路径 type-aliases-package: com.example.entity # 实体类包路径 ``` 3. **依赖版本兼容** - 需保证 `spring-boot-starter-parent`、`mybatis-spring-boot-starter` 版本匹配[^5] - 典型兼容版本示例： ```xml <mybatis-spring-boot-starter.version>2.2.0</mybatis-spring-boot-starter.version> <spring-boot.version>2.4.5</spring-boot.version> ``` #### 二、无法扫描到 Mapper 的排查流程 1. **检查包层级结构** - 确认 `@Mapper` 接口是否在启动类同级/子包 - 示例结构： ``` src/main/java └── com.example ├── Application.java # 启动类 └── mapper └── UserMapper.java # @Mapper接口 ``` 2. **验证 XML 映射配置** - 检查 `application.yml` 中 `mapper-locations` 是否指向正确的 XML 文件路径 - 确认 XML 文件中 `namespace` 与接口全限定名一致： ```xml <mapper namespace="com.example.mapper.UserMapper"> <select id="selectById" resultType="User"> SELECT * FROM user WHERE id = #{id} </select> </mapper> ``` 3. **查看编译结果** - 检查 `target/classes` 目录是否包含： - 编译后的 `UserMapper.class` - `mapper/UserMapper.xml`（位于 resources 目录） 4. **检查方法签名一致性** - 接口方法与 XML 定义需 **严格匹配参数名和返回值类型**[^2] - 推荐使用 `@Param` 注解明确参数名： ```java @Mapper public interface UserMapper { User selectById(@Param("id") Long id); } ``` 5. **排查版本冲突** - 执行 `mvn dependency:tree` 查看依赖树 - 常见冲突场景： - MyBatis 与 MyBatis-Plus 混用未统一版本 - Spring Boot 2.x 使用 MyBatis 3.4.x+ #### 三、典型问题解决方案 **案例：变更启动类位置后扫描失效** 1. 添加显式扫描注解： ```java @SpringBootApplication @MapperScan("com.newpackage.mapper") // 新包路径 public class NewApplication {} ``` 2. 确认新路径包含所有 Mapper 接口 **案例：XML 映射文件未加载** 1. 检查 Maven 配置确保 XML 文件被包含： ```xml <build> <resources> <resource> <directory>src/main/resources</directory> <includes> <include>**/*.xml</include> </includes> </resource> </resources> </build> ``` #### 四、调试辅助方法 1. 启用 MyBatis 日志： ```yaml logging: level: org.mybatis: DEBUG ``` 2. 观察启动日志中是否输出： ``` Mapped "{...}" onto com.example.mapper.UserMapper.selectById ```