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

本文详细解析了MyBatis中常见的Invalid bound statement (not found)异常,并提供了详细的排查及解决方案,包括检查包名、namespace、函数名称等。

本文转自:http://ljhzzyx.blog.163.com/blog/static/38380312201412453629988/

Mybatis常会出现下面异常,这一般是xml映射文件有错误。但是这个提示不一定准确,以致网上有些资料说这个问题很奇怪。出现这个错误一般的解决方式在下面有说明:

http://blog.youkuaiyun.com/softwarehe/article/details/8889206

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

  一般的原因是Mapper interface和xml文件的定义对应不上,需要检查包名,namespace,函数名称等能否对应上。

按以下步骤一一执行:

1:检查xml文件所在的package名称是否和interface对应的package名称一一对应

2:检查xml文件的namespace是否和xml文件的package名称一一对应

3:检查函数名称能否对应上

4:去掉xml文件中的中文注释

5:随意在xml文件中加一个空格或者空行然后保存

  以上步骤除第5步,其他步骤没什么问题。第5步看起来这么怪异的解决方式,实际上是触发了ide的自动编译功能。由于xml文件在编译的时候,不一定总能立即从源目录复制到class文件的编译目录(MyEclipse经常出这个问题),

有时候你源目录中的xml文件已经修改好了, 而class所在的目录里面还是旧的。因此真正确定有效的方式是将正确的xml文件复制到class输出目录。

  还有种情况会出这个错误,比如配置xml映射文件需要满足特定要求  

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"
          p:dataSource-ref="dataSource" 
          p:configLocation="classpath:mybatis-config.xml">
    <property name="mapperLocations">
           <list>
               <value>classpath*:mapper/com/xxx/**/*Mapper.xml</value>      <-- 我的错误是这里的路径加载错了 -->
           </list>
     </property>
</bean>

  如上只有Mapper结尾的xml文件才会被Mybatis扫描到,这个时候如果忘记了这个规则,xml使用了其他名称,如xxxDao.xml。这样xml的配置就不会加入到Mybatis存储配置的一个map对象里去,也会出现 Invalid bound statement

的错误。解决方法就是把xml文件改名即可。

### 解决 `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、付费专栏及课程。

余额充值