遇到Invalid bound statement (not found)踩的坑

本文记录了在使用Spring Boot与Mybatis进行单元测试时,如何解决mapper接口找不到的问题,重点在于XML映射文件的正确编译路径配置。通过新建包结构并调整mapper-locations配置,解决了mapper文件未按预期编译的问题。

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

代码

@RunWith(SpringRunner.class)
@SpringBootTest
public class MybatisTest {
    @Autowired
    private DataSource dataSource;
    @Autowired
    private MemberPOMapper memberPOMapper;

    private Logger log=LoggerFactory.getLogger(MybatisTest.class);
    @Test
    public void testMapper(){
        BCryptPasswordEncoder passwordEncoder = new BCryptPasswordEncoder();
        String source="123123";
        String encode = passwordEncoder.encode(source);
        MemberPO memberPO = new MemberPO(null, "jack", encode,
                "杰克", "jack@qq.com", 1, 1, "杰克",
                "123123", 2);
        memberPOMapper.insert(memberPO);

    }
    }

遇到的问题

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.atguigu.crowd.mapper.MemberPOMapper.insert

看了一下我的application.yml是没有问题的

server:
  port: 2000
spring:
  application:
    name: atguigu-crowd-mysql
  datasource:
    name: mydb
    type: com.alibaba.druid.pool.DruidDataSource
    url: jdbc:mysql://127.0.0.1:3306/project_crowd?serverTimezone=UTC
    username: root
    password: 123456
    driver-class-name: com.mysql.cj.jdbc.Driver
eureka:
  client:
    service-url:
      defaultZone: http://localhost:1000/eureka
mybatis:
  mapper-locations: classpath*:/mybatis/mapper/*Mapper.xml
logging:
  level:
    com.atguigu.crowd.mapper: debug
    com.atguigu.crowd.test: debug

原因

排查后发现xml并没有像接口那样按照文件层级编译,而是被当做了一个文件夹名为mybatis.mapper的文件夹处理。

操作

重新建mybatis包和mapper包,记住要分开建包,然后删除之前的target,重新运行,然后就成功了。

结果

在这里插入图片描述

### 解决 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、付费专栏及课程。

余额充值