运行Maven项目:org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)

本文介绍了一个常见的Maven+Spring+SpringMVC+MyBatis项目搭建过程中遇到的问题:MyBatis的映射文件未能正确加载导致运行时报错。文中详细解释了错误的原因,并提供了解决方案——通过在pom.xml文件中加入特定配置让Maven能够正确地将映射文件打包进目标文件夹。

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

问题:

用Maven + Spring + SpringMVC + mybatis搭建项目时,测试项目是否能够运行,报了以下错误:

这里写图片描述

原因分析:

从报错原因可以知道,错误原因是 mybatis框架的错误, 无效的绑定语句,出现这个原因一般是mapper配置文件出错或者丢失,然而检查mapper配置文件,发现没有丢失,也没有出错。

既然mybatis中配置不存在问题,那么问题极有可能在Maven中!因此分析一下Maven,Maven项目运行的目标文件例如class文件,都会在target文件夹中

这里写图片描述

target文件夹内:

这里写图片描述

Maven管理下的web项目正是依靠taget文件夹下的classes文件,当我们执行xxxMapper.class文件时,由mybatis的规则可以知道,mapper映射文件xxxMapper.xml必须和xxxMapper.java文件在同一个目录,然而当前再classes文件中,只有class文件,而没有xml文件,因此运行class文件的方法时,根本找不到对应的映射语句,这就造成了语句绑定失效

解决方法:

  1. 复制xml映射文件到target的class文件同目录下(这样做非常麻烦,当mapper文件很多的情况下)
  2. 把xml配置的事由Maven来管理:
    在该项目的pom.xml文件下,加上:
<!-- 如果不添加此节点mybatis的mapper.xml文件都会被漏掉。 -->  
    <build>  
        <resources>  
            <resource>  
                <directory>src/main/java</directory>  
                <includes>  
                    <include>**/*.properties</include>  
                    <include>**/*.xml</include>  
                </includes>  
                <filtering>false</filtering>  
            </resource>  
        </resources>  
    </build> 

意思是:Maven扫描java/main/src文件时,要把.properties和.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、付费专栏及课程。

余额充值