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

### 解决 `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]。 ---