invalid bound statement not found

### 解决 MyBatis 中 Invalid Bound Statement (Not Found) 的问题 当遇到 `Invalid bound statement (not found)` 错误时，通常是因为 MyBatis 无法找到对应的 SQL 映射语句。以下是可能导致该错误的原因及其解决方案： #### 可能原因及解决方法 1. **Mapper 文件路径配置错误** 如果 Mapper XML 文件未被正确加载到项目中，则会导致绑定失败。可以通过以下方式验证： - 确认 Spring 或 MyBatis 配置文件中是否已正确定义了 `<mappers>` 节点，并指定了正确的路径[^3]。 ```xml <mappers> <mapper resource="com/example/dao/AUserDao.xml"/> </mappers> ``` 2. **Namespace 定义不匹配** Namespace 是 MyBatis 将接口与 XML 文件关联的关键部分。如果定义的 namespace 不一致，MyBatis 就无法找到对应的方法声明。 - 确保 Mapper 接口中的全限定名与其对应的 XML 文件中的 `namespace` 属性完全一致。 ```java public interface AUserDao { List<User> findBySearch(); } ``` 对应的 XML 文件需设置相同的命名空间： ```xml <mapper namespace="com.example.dao.AUserDao"> <select id="findBySearch" resultType="User"> SELECT * FROM users WHERE ... </select> </mapper> ``` 3. **SQL ID 名称拼写错误** 方法名称和 XML 文件中的 `<select>` 标签的 `id` 属性必须严格保持一致。任何大小写或字符上的差异都会引发此问题。 - 检查调用代码中的方法名是否与 XML 文件中的 `id` 值相匹配。 4. **扫描机制失效** 当使用基于注解的方式自动扫描 Mapper 接口时，可能由于某些原因导致扫描未能成功完成。可以尝试手动注册 Mapper 接口来排除此类问题。 - 在 MyBatis 配置中显式添加 Mapper 类型支持： ```java SqlSessionFactoryBean sqlSessionFactory = new SqlSessionFactoryBean(); sqlSessionFactory.setMapperLocations(new PathMatchingResourcePatternResolver() .getResources("classpath*:mappings/*.xml")); ``` 5. **依赖注入问题** 若 Mapper 接口未被正确实例化为 Bean，则即使 XML 文件存在也无法正常工作。确保在 Spring 上下文中启用了 MyBatis 扫描功能。 - 添加如下配置以启用自动扫描： ```java @Configuration @MapperScan(basePackages = "com.example.dao") public class MyBatisConfig {} ``` 6. **其他潜在因素** 还可能存在诸如版本冲突、资源文件丢失等问题。建议清理并重新构建项目以消除这些隐患。 ```bash mvn clean install ``` --- ### 示例代码片段 假设我们有一个名为 `AUserDao` 的 Mapper 接口以及其对应的 XML 文件： ```java public interface AUserDao { User findById(int id); } ``` 相应的 XML 文件内容如下所示： ```xml <mapper namespace="com.example.dao.AUserDao"> <select id="findById" parameterType="int" resultType="User"> SELECT * FROM users WHERE id = #{id}; </select> </mapper> ``` 确保以上两部分内容无语法错误且相互兼容即可有效规避 `Invalid bound statement` 报错情况的发生。 ---