org.apache.ibatis.binding.BindingException: Invalid bound statement (not found):

最新推荐文章于 2025-06-18 00:26:59 发布
转载 最新推荐文章于 2025-06-18 00:26:59 发布 · 1.6k 阅读 · 1
文章标签：

#异常

本文介绍了在SpringBoot项目中整合MyBatis时遇到的org.apache.ibatis.binding.BindingException错误及其解决办法。主要原因是未能正确加载xxxMapper.xml文件，解决方法是在application.yml配置文件中指定mapper-locations路径。

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

今天写spring boot 整合mybatis的时候遇到org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)这个错，找了很久，总结原因是因为扫描不到xxxMapper.xml。

在这里插入图片描述

解决方法：在application.yml（application.properties）文件里添加

mybatis:
  mapper-locations: classpath:mapping/*.xml

或者直接使用java注解方式，不用xml映射

【MyBatis】org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)完整解决方案思路全纪录
橙-极纪元-JJYCheng
08-20 3075
【MyBatis】org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)完整解决方案思路全纪录
解决org.apache.ibatis.binding.BindingException: Invalid bound statement (not found):xxx问题
念兮为美
11-28 1万+
解决org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.cloud.lowcode.mapper.UserMapper.queryByParam问题
org.apache.ibatis.binding.BindingException Invalid bound statement (not found)
xugehahaha的博客
04-18 6040
显示绑定异常，没有找到对应的SQL语句。
IntelliJ IDEA：Invalid bound statement (not found)
最新发布
qq_56486237的博客
06-18 584
IntelliJ IDEA：Invalid bound statement (not found)
mybatis绑定错误
热门推荐
softwarehe的专栏
05-06 16万+
如果出现： org.apache.ibatis.binding.BindingException: Invalid bound statement (not found) 一般的原因是Mapper interface和xml文件的定义对应不上，需要检查包名，namespace，函数名称等能否对应上，需要比较细致的对比，我经常就是写错了一两个字母搞的很长时间找不到错误
org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)
空空墓志铭的博客
08-23 7万+
Springboot项目中，在mybatis中mapper数据库操作接口(有的称DAO，有的直接说mapper,都只同一文件)与mapper配置文件在做映射绑定的时候出现问题，简单说，就是接口与xml要么是找不到，要么是找到了却匹配不到。select元素中resultMap属性名在xml文件中有对应的resultMap元素，且元素的id与select元素的resultMap属性保持一致。4）xml文件文件名不对，后缀名不是xml，有的时候新建了个不是xml的文件，写好内容后，文件后缀名忘记修改。
多数据源使用mybatis-plus报错:org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)
m0_50163856的博客
05-04 757
【代码】多数据源使用mybatis-plus报错:org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)
（报错记录）mybatis整合mybatis-plus错误org.apache.ibatis.binding.BindingException: Invalid bound statement
eggplantttttt的博客
03-21 1742
org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.mindskip.xzs.repository.SubjectMapper.page at com.baomidou.mybatisplus.core.override.PageMapperMethod$SqlCommand.<init>(PageMapperMethod.java:261) ~[mybatis-plus-co
解决java中mybatis报错：org.apache.ibatis.binding.BindingException：Invalid bound statement (not found)：xx
水巷石子的博客
01-14 756
org.apache.ibatis.binding.BindingException：Invalid bound statement (not found)：xx
【SpringBoot分布式】解决org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)异常
m0_47109389的博客
08-15 5654
解决org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)异常
【mybatis】mybatis访问报错：org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)...
weixin_34402408的博客
11-08 5566
mybatis访问报错：org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)   需要检查的步骤： 1.是否mapper.java文件上使用了注解@Mapper  或者 在启动类上扫描了Mapper类 @MapperScan("com.swapping.springcloud.ms.integ...
BindingException ：Invalid bound statement (not found)
Cold_Night_的博客
11-27 548
今天在使用maven时出现了如下错误： BindingException ：Invalid bound statement (not found) 在网上查询之后，发现基本都是让在pom.xml中添加如下代码，以确保xml文件可以被扫描dao， 但是，还是照常报错。 经过我的不断查找后，终于找到了这个小错误，如下： 进入此xml文件所在的文件夹，这个生成的文件夹本该是cn/baidu/map...
解决org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)
m0_56698268的博客
09-07 2721
org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)问题，即在mybatis中dao接口与mapper配置文件在做映射绑定的时候出现问题，简单说，就是接口与xml要么是找不到，要么是找到了却匹配不到。 可能有以下几个可能性，一一进行排查： xml文件中namespace中的包名要和Mapper接口的包名一致 BlogMapper中的方法，在BlogMapper.xml文件中没有 Mapper接口中
【报错】：org.apache.ibatis.binding.BindingException: Invalid bound statement (not found):
简单Cere
04-29 487
mybatis-Plus自动生成代码之后，由于是多表关联查询，所以在mapper.xml中写sql语句。
org.apache.ibatis.binding.BindingException:Invalid bound statement
12-27
### 解决 `org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)` 错误 当遇到 `org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)` 这一错误时，通常意味着 MyBatis 无法找到指定的 SQL 映射语句。以下是几种常见的解决方案： #### 方法一：确保 Mapper 文件中的 SQL 语句 ID 和 Java 代码中调用的方法名一致 如果 Mapper 接口中的方法名称与对应的 XML 配置文件内的 `<select>` 或其他标签下的 id 属性不匹配，则会触发此异常。因此，应当仔细核对两者之间的命名是否完全相同。 ```xml <!-- UserMapper.xml --> <select id="getUserById" parameterType="int" resultType="com.example.User"> SELECT * FROM users WHERE user_id = #{userId} </select> ``` ```java //UserMapper.java public interface UserMapper { @Select("SELECT * FROM users WHERE user_id = #{userId}") public List<User> getUserById(int userId); } ``` 注意，在上面的例子中，`id` 的值应与接口里的函数签名相吻合[^2]。 #### 方法二：确认资源文件被正确打包至 JAR 中 有时即使路径无误，由于 Maven 构建过程配置不当也可能导致此类问题的发生。可以通过检查项目的 `pom.xml` 来验证是否有如下设置来包含所有的映射器XML文件: ```xml <build> <resources> <!-- 添加 resource 节点用于加载 mapper xml 文件 --> <resource> <directory>src/main/resources</directory> <includes> <include>**/*.properties</include> <include>**/*.yml</include> <include>**/*.yaml</include> <include>**/*.xml</include> </includes> </resource> </resources> </build> ``` 此外，还需保证这些文件确实存在于预期的位置，并且在编译后的 jar 包内可以正常访问[^4]。 #### 方法三：升级依赖版本以兼容更高版本框架 对于某些特定情况下，比如使用较新的Spring Boot 版本而MyBatis Plus尚未提供相应支持的时候，可能会因为API变更等原因引发该类异常。此时建议查看官方文档或社区反馈了解是否存在已知的问题以及相应的修复措施；必要时考虑更新相关库到最新稳定版以便获得更好的适配性和性能优化[^3]。 ---
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值