彻底解决MyBatis映射失败的问题(Invalid bound statement (not found)）

最新推荐文章于 2024-05-28 14:10:41 发布

Pan's pidr

最新推荐文章于 2024-05-28 14:10:41 发布

阅读量8.5k

点赞数 1

分类专栏： Java后端文章标签： java mybatis spring maven bug

本文链接：https://blog.csdn.net/weixin_42972730/article/details/112800598

版权

Java后端专栏收录该内容

14 篇文章

订阅专栏

当遇到MyBatis映射失败的问题时，主要从名字匹配和文件扫描两方面进行排查。确保接口名字、namespace及方法名一致，检查接口是否被正确扫描，Mapper.xml文件是否在扫描范围内，以及target文件夹下是否存在mapper.xml。解决方案包括调整注解、配置扫描路径和正确放置XML文件。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

解决问题要从问题的本质去找方法，比如MyBatis映射不对，只有两种可能，一种是因为名字对应不上，比如接口的名字和namespace不对应，或者里面的方法名字不对应之类的；另一种就是找不到文件，或者找不到接口文件，或者找不到Mapper.xml文件

所以MyBatis映射失败的时候，应该从以下几个方向去解决

检查名字

检查接口名字和mapper中的namespace
检查方法名是否一致

这两个方法都可以通过插件来很好的解决，如果装上MyBatis插件之后可以相互跳转，说明名字没有问题。

检查文件

检查接口是否被扫描

有两种方法实现扫描接口

一种方法是为每个接口加上@Mapper注解，表明这是一个Mapper；

另一种方法是在启动类加上@MapperScan("com.xxx.yyy.mapper")来扫描Mapper包，注意不要将范围设置的太大，不然会在Service层或者Controller层报错。

PS：@Mapper应该不会标记错，可能出错的就是@MapperScan中的包的名字错了，这个时候会出现Mapper自动注入的问题。

检查mapper.xml是否被扫描

扫描的方法是在properties文件中添加mybatis.mapper-locations=classpath:mappers/*.xml通过这样的方式配置mapper.xml所在的位置。

target文件夹下没有mapper.xml

需要注意的是，可能有些朋友的 xml 文件不能被识别，比如没有放到resources目录下的xml文件不会被扫描到。

检查方法是看target文件夹下是否有mapper .xml 文件，这个是maven的扫描规定导致的。

解决方法有两种：

一种方法是将mapper.xml文件放到resources目录下。

另一种方法是在pom文件的节点中加入如下内容

<resources>
	<resource>
		<directory>src/main/java</directory>
		<includes>
			<include>**/*.xml</include>
		</includes>
	</resource>
</resources>

如图所示

通过这种方法指定资源的路径，不过这样的话，可能会导致其他资源扫描不到，所以稳妥的方法还是按照规定，将xml文件放到resources文件夹下。