【开发日志】Invalid bound statement (not found)问题原因

在新增mapper时会犯到的错误,当你写完controller->service->impl->mapper->xml之后满心欢喜的启动项目,发现直接报错Invalid bound statement (not found),崩溃了,问题出在哪儿呢?

对应不上mapper

检查步骤:

  1. 有没有这个xml

  2. xml中的mapper和实体类能否对应

  3. xml是否与mapper层级一致

    如mapper存放于com.xxx.mapper包下,那么xml要放在resource.mapper包下,如果resource包下没有mapper目录,那么需要手动创建一个,不能直接放在resource包下

### 解决 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` 报错情况的发生。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值