java~springboot~ibatis Invalid bound statement (not found)原因

本文详细介绍了在使用ibatis进行ORM开发时遇到的'Invalidboundstatement(notfound)'问题,并提供了排查和解决该问题的方法。通过分析可能出现的错误原因,包括XML输入参数类型不匹配、返回参数类型问题、DTO与结果集名称不匹配等,作者指导读者如何正确配置映射文件和yml文件,确保代码的一致性,从而避免和解决此类问题。

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

事实起因

最近在ORM上使用了ibatis,感觉挺繁琐的,没有jpa来的直接,但项目非要用也没有办法,最近在进行开发过程中出现了一个问题Invalid bound statement (not found)意思是说,你的xml映射和你的mapper方法不一致,这种不一致大叔总结几点,如果你出现了这种问题可以按着下面几后进行排查。

可能出现的原因
  1. xml输入参数类型不匹配,你可以改成parameterType="map"试试
  2. xml返回参数类型问题,resultType="你的类型",不要写成resultMap="你的类型"
  3. 返回的DTO与返回结果集名称不匹配,这时你要对照类型的属性,去为sql设置别名
  4. yml文件里对ibatis配置有问题
    如下面代码:
@Getter
@Setter
public class BusinessCustomerDTO {
private Long id;
private String customerName;
private String contactPerson;
private Integer freeDays;
private String city;
private String province;
private String source;
private LocalDateTime enterDays;
private String leadingPerson;
}

对应的mapper代码:

  <select id="getBusinessCustomers" parameterType="java.util.Map" resultType="cn.pilipa.customer.management.dto.BusinessCustomerDTO">
        select a.id,
        a.customer_name as customerName,
        a.city_code as city,
        a.province_code as province,
        a.customer_source as source,
        b.enter_storage_time as enterDays,
        b.current_salesperson as leadingPerson,
        c.contact_person as contactPerson from customer_base_info a
        inner join customer_business_info b on a.id=b.customer_id
        left join customer_contact_person  c on c.customer_id=a.id
        where c.is_main_contact=1
    </select>
### Spring Boot 中 'Invalid bound statement (not found)' 错误的解决方案 此错误通常发生在 MyBatis 或 MyBatis-Plus 配置不当的情况下,具体表现为无法找到 Mapper 接口或其对应的 XML 文件。以下是对此问题的深入解析和解决方法。 #### 1. 检查 `@MapperScan` 注解是否正确配置 如果项目中未正确扫描到 Mapper 接口所在的包,则可能导致该错误。需确保在启动类或其他配置类上添加了 `@MapperScan` 注解,并指定正确的包路径[^1]: ```java @SpringBootApplication @MapperScan("com.example.mapper") // 替换为实际的Mapper接口所在包路径 public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` #### 2. 确认 `mybatis.mapper-locations` 是否指向正确的 XML 路径 MyBatis 的映射文件(XML)需要被正确加载才能与 Mapper 接口绑定。可以通过设置 `mybatis.mapper-locations` 属性来指定 XML 文件的位置[^3]。例如,在 `application.yml` 中配置如下: ```yaml mybatis: mapper-locations: classpath:mapper/*.xml # 替换为实际的XML文件位置 ``` 注意:路径中的通配符应匹配项目的目录结构,否则可能遗漏某些 XML 文件。 #### 3. 核实 Mapper 接口名称与 XML 文件名的一致性 MyBatis 默认会根据 Mapper 接口全限定名寻找同名的 XML 文件。因此,确保 Mapper 接口的命名与其对应 XML 文件保持一致是非常重要的[^2]。例如,对于以下接口定义: ```java package com.example.mapper; import org.apache.ibatis.annotations.Mapper; import com.baomidou.mybatisplus.core.mapper.BaseMapper; @Mapper public interface UserMapper extends BaseMapper<User> {} ``` 其对应的 XML 文件应当命名为 `UserMapper.xml` 并放置于上述配置所指的路径下。 #### 4. 检查依赖版本兼容性 不同版本的 Spring Boot 和 MyBatis/MyBatis-Plus 可能存在兼容性问题。建议查阅官方文档并调整至推荐组合版本。例如,当使用 Spring Boot 3.x 版本时,可搭配 MyBatis-Plus 3.5.x 使用。 #### 5. 排查 IDE 设置影响 部分开发工具(如 IntelliJ IDEA)可能存在大小写敏感度差异的情况,这可能会干扰资源定位逻辑[^4]。可通过清理缓存 (`File -> Invalidate Caches / Restart`) 来尝试解决问题;或者切换构建工具命令运行程序以排除环境因素干扰。 --- ### 示例代码片段 以下是一个完整的 Maven 项目示例配置,展示如何集成 MyBatis-Plus 并规避常见配置陷阱: ```xml <dependencies> <!-- Spring Boot Starter --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- MyBatis Plus --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.9</version> </dependency> <!-- MySQL Driver --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency> </dependencies> ``` 同时,确保数据库连接池等相关组件已正确定义。 --- ####
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值