Spring Boot 2.0+MyBatis整合BaseMapper异常解决

在使用Spring Boot 2.0及以上版本与MyBatis进行整合时，开发者通常会借助BaseMapper<T>接口来简化CRUD操作。但有时，当你调用BaseMapper中定义的方法时，可能会遇到“方法未绑定”或“找不到对应的SQL映射”的异常。

异常原因

1. Mapper接口与XML映射文件不匹配

• 确保你的Mapper接口与对应的XML映射文件是匹配的。XML映射文件的namespace应该与Mapper接口的全限定名相同。

2. XML映射文件位置不正确

• 确保XML映射文件被放置在正确的位置，并且被Spring Boot扫描到。默认情况下，它应该位于resources/mapper目录下。

3. 缺失必要的MyBatis配置

• 确保你已经在Spring Boot的配置文件中加入了MyBatis的相关配置，并且配置了Mapper扫描的路径。

4. 依赖冲突或版本不兼容

• 有时，不同版本的库之间可能存在冲突或兼容性问题。确保你使用的Spring Boot、MyBatis和其他相关依赖的版本是兼容的。

解决方案

1. 检查Mapper接口与XML映射文件

确保BaseMapper<T>接口中定义的方法在XML映射文件中都有对应的SQL语句映射。

示例：

假设你有一个UserMapper接口继承自BaseMapper<User>：

public interface UserMapper extends BaseMapper<User> {
    // 自定义方法
}

对应的XML映射文件UserMapper.xml应该位于resources/mapper目录下，并且包含BaseMapper中所有方法的SQL映射。

2. 确保XML映射文件位置正确

确保UserMapper.xml文件位于src/main/resources/mapper目录下，且文件内容正确。

3. 添加或检查MyBatis配置

在application.properties或application.yml中，确保配置了MyBatis的Mapper扫描路径。

application.properties 示例：

mybatis.mapper-locations=classpath:mapper/*.xml
mybatis.type-aliases-package=com.yourdomain.yourapp.model

application.yml 示例：

mybatis:
  mapper-locations: classpath:mapper/*.xml
  type-aliases-package: com.yourdomain.yourapp.model

4. 检查依赖版本兼容性

确保你的pom.xml或build.gradle文件中的Spring Boot、MyBatis和其他相关依赖的版本是兼容的。可以参考Spring Boot的官方文档或其他可靠的资源来获取推荐的依赖版本。

5. 重启应用

在做出上述更改后，确保重启你的Spring Boot应用，以便让更改生效。

通过以上步骤，你应该能够解决在Spring Boot 2.0+与MyBatis整合过程中，使用BaseMapper<T>接口时遇到的方法未绑定异常。如果问题依然存在，建议检查具体的错误信息，以便更精确地定位问题所在。