“invalid bound statement (not found)”错误源于mapper接口与xml映射文件绑定失败，需依次检查：一、命名空间与路径是否匹配；二、xml是否被正确加载至类路径；三、方法名与sql id是否完全一致；四、spring中是否启用mapper扫描；五、xml语法是否合法且未被注释。
如果您在使用MyBatis时遇到“Invalid bound statement (not found)”错误，通常是因为Mapper接口方法与XML映射文件中的SQL语句未正确绑定。以下是解决此问题的步骤：
一、检查Mapper接口与XML文件命名及路径是否匹配
MyBatis默认要求Mapper接口的全限定名（包名+接口名）必须与XML文件的namespace属性完全一致，且XML文件需放置在类路径下对应包结构的位置。若路径或命名不一致，MyBatis将无法定位到对应的SQL语句。
1、确认Mapper接口所在包路径，例如com.example.mapper.UserMapper。
2、检查XML文件是否位于src/main/resources/com/example/mapper/UserMapper.xml路径下（Maven项目标准结构）。
3、打开XML文件，验证<mapper namespace="com.example.mapper.UserMapper"></mapper>中的namespace值是否与接口全限定名完全一致，包括大小写和包分隔符。
二、确认XML文件是否被正确加载进类路径
编译后XML文件若未出现在target/classes对应目录中，则MyBatis运行时无法读取该文件，导致绑定失败。常见于IDE配置或构建工具未识别非Java资源文件。
1、在Maven项目中，检查pom.xml是否遗漏<resources></resources>配置，确保src/main/resources下的XML文件被包含。
2、在IntelliJ IDEA中，右键点击XML文件，选择“Reload project from Maven”或执行“Build → Rebuild Project”。
3、启动应用后，进入target/classes目录，手动验证com/example/mapper/UserMapper.xml是否存在且内容完整。
三、核对Mapper接口方法名与XML中id属性是否严格一致
MyBatis通过接口方法名与XML中<select></select>、<update></update>等标签的id属性进行匹配。二者必须为**完全相同的字符串**，不可有拼写差异、空格或大小写偏差。
1、查看接口中定义的方法，例如User selectById(Long id);。
2、在XML中查找对应<select id="selectById" ...></select>，确认id值为selectById而非selectbyid或selectByIds。
3、若方法含重载，确保每个重载方法均有唯一且匹配的XML中id声明。
四、检查Spring配置中是否已正确注册Mapper扫描
在Spring整合MyBatis场景下，若未启用Mapper接口自动代理机制，接口将无法关联XML中的SQL语句，从而触发绑定异常。
1、确认Spring配置类或XML中已添加@MapperScan("com.example.mapper")注解，且包路径覆盖所有Mapper接口。
2、若使用XML方式配置，检查<scan base-package="com.example.mapper"></scan>是否存在于applicationContext.xml中。
3、排除重复配置：确保同一Mapper接口未同时通过@Mapper注解和@MapperScan注册，避免代理冲突。
五、验证XML文件语法是否合法且未被意外注释
XML文件若存在格式错误（如未闭合标签、非法字符）或整段SQL被误置于<!-- -->注释中，MyBatis解析器将跳过该语句，导致id不可见。
1、用XML校验工具或IDE打开UserMapper.xml，确认无红色波浪线报错，且根元素为<mapper></mapper>。
2、逐个检查<select></select>、<insert></insert>等标签是否闭合，属性值是否加引号，嵌套<if></if>等动态SQL是否语法合规。
3、搜索文件中是否存在
