Spring Boot整合MyBatis：@Mapper、@MapperScan和mybatis.mapper-locations如何协同工作？

Spring Boot集成MyBatis时，@Mapper、@MapperScan注解和mybatis.mapper-locations配置文件参数如何协同工作？本文将详细解释它们之间的区别，并说明为何缺少mybatis.mapper-locations配置会导致org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)错误。

Invalid bound statement (not found)错误表明MyBatis无法找到对应的SQL映射语句。虽然@Mapper（用于单个Mapper接口）、@MapperScan（用于扫描多个Mapper接口）和mybatis.mapper-locations都与Mapper接口定位相关，但它们的功能不同。

@Mapper注解将一个接口标记为MyBatis的Mapper接口，指示Spring创建该接口的动态代理对象。此代理对象执行接口方法并调用相应的SQL语句。需要注意的是，@Mapper只能用于单个Mapper接口。

@MapperScan注解扫描指定包下所有Mapper接口，并为其生成动态代理对象，避免在每个接口上都添加@Mapper注解。它简化了配置，一次性处理多个Mapper接口。

mybatis.mapper-locations=classpath:mapper/*.xml配置项指定了MyBatis映射文件（.xml文件）的路径。MyBatis正是通过这些.xml文件找到具体的SQL语句。@Mapper和@MapperScan注解仅告知Spring哪些接口是Mapper接口并生成代理，但它们并未告诉MyBatis在哪里查找SQL映射语句，而这些语句定义在.xml文件中。

因此，仅使用@Mapper或@MapperScan，MyBatis虽然能找到Mapper接口，却找不到对应的SQL语句，从而抛出Invalid bound statement (not found)错误。添加mybatis.mapper-locations配置后，MyBatis就能根据路径找到.xml文件，正确执行SQL语句。注解负责Mapper接口的扫描和代理生成，配置文件负责指定SQL映射文件位置，两者缺一不可。

以上就是Spring Boot整合MyBatis：@Mapper、@MapperScan和mybatis.mapper-locations如何协同工作？的详细内容，更多请关注php中文网其它相关文章！