mybatis+springboot启动异常：Caused by: org.apache.ibatis.binding.BindingException: Invalid bound statemen

最新推荐文章于 2025-10-12 20:48:27 发布
原创 最新推荐文章于 2025-10-12 20:48:27 发布 · 1.1k 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文介绍了一种常见的MyBatis XML映射文件加载失败的问题及解决方案。通过调整application.properties配置文件中的mybatis.mapperLocations属性，从使用单个classpath关键字改为使用classpath*关键字，成功解决了XML映射文件无法被MyBatis正确加载的问题。此外，文章还提到了将XML文件导入项目并重新构建也是解决问题的有效方法。

按照网上的匹配一遍，没发现问题，最修改application.properties配置文件中mybatis.mapperLocations=classpath:mapper/*.xml 
为 
mybatis.mapperLocations=classpath*:mapper/*.xml 

可以运行了。后来发现不是这个问题，把XML文件拉过来之后，重新build一下就可以了。

【MyBatis】org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)完整解决方案思路全纪录
橙-极纪元-JJYCheng
08-20 3488
【MyBatis】org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)完整解决方案思路全纪录
Caused by: org.apache.ibatis.binding.BindingException: Parameter ‘memberId‘ not found. Available par
知识改变命运，ヾ(◍°∇°◍)ﾉﾞ【求关注】
04-07 963
更新时报错
Spring Boot整合Mybatis出现org.apache.ibatis.binding.BindingException: Invalid bound statement (not found
我在阴山下
08-29 6389
异常描述 nested exception is org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): 解决方法 查阅网上大量资料，然后仔细检查DAO对应的相关xxxDAO.xml文件,然后发现namespace写错了，修正后就恢复正常了 建议： - 仔细检查reources...
【bug日记】mybatis-plus报错org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)
qq_32792547的博客
01-07 2249
昨天在使用SpringBoot + Mybatis-plus进行项目开发，使用Mybatisx工具根据表结构自动生成domain、mapper、service类，在进行方法测试的时候，出现报错： org.apache.ibatis.binding.BindingException: Invalid bound statement (not found) 困扰了一下午 + 半个晚上，最后成功解决
Mybatis报错org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.easyli
最新发布
qq_61294100的博客
10-12 223
可以发现mapper接口在com/easylive/web/mappers文件夹下，而mapper.xml文件在com.easylive.web.mapper文件夹下，因此报错。④查看target目录mapper接口和mapper.xml文件是否在同一个文件夹下 --②mapper.xml的namespace是否和mapper接口的全类限定名一致 -在resource文件夹下建立文件夹时，主要要用“/”进行分割，而不是“.”①mapper接口和mapper.xml文件的包路径是否一致 --
org.apache.ibatis.binding.BindingException: Invalid bound statement (not found):的三种解决方式
热门推荐
weixin_47316183的博客
05-08 2万+
在使用mybatis-plus自定义SQL的时候，没有使用注解方式，而是将SQL语句写在mappper.xml文件中，就报了这个错：org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): 说某个方法没找到。 原因：maven默认加载机制，只会把src/main/java文件夹中的java类型文件进行加载，其他类型文件不会加载 解决方式： 方式一：手动复制xml文件到target目录 方式二：将xml文
Caused by: org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): cn.com.
qq_42977971的博客
05-26 675
Caused by: org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): cn.com.dhcc.di.common.person.mapper.PersonShoppingMapper.listPersonShopping ![在这里插入图片描述](https://img-blog.csdnimg.cn项目可以正常启动，但是当当访问接口时候，就报下面的错误， 原因是mapper.xml找不到对应的
Caused by: org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.XXX.
QianKun
12-06 1352
Caused by: org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.XXX.
MyBatis多参数Caused by: org.apache.ibatis.binding.BindingException: Parameter ‘loginNo‘ not found.
baidu_38995168的博客
05-08 540
Caused by: org.apache.ibatis.binding.BindingException: Parameter ‘loginNo’ not found. Available parameters are [arg1, arg0, param1, param2] 修改前： 在这里插入代码片 /** * 通过用户登录编号和密码查询用户信息 * @param loginNo * @param password * @return */
解决报错：org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.atguigu
w20001118的博客
07-10 2095
spring项目中，使用mybatis编写xml以后，项目启动报错：org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.atguigu.service.mapper.EduCourseMapper. 先说结论，此处报错的原因是maven默认情况下，只会将java文件进行编译打包，此处mybatis的mapper.xml文件没有加载进targer目录，无法读取，自然启动不了，如图mapper包
Caused by: org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.exam
weixin_42019784的博客
06-04 1597
解决方案： 1、查看pom.xml中build下的资源路径，默认情况下，包含src/main/resources路径下的**/**，即所有文件；如果有手动设置，注意需要包含 .xml和 *.properties，否则会出现死活找不到映射的情况！！！ 2、查看配置文件中mybatis.mapper-locations是否正确 3、查看.xml文件中namespace是否映射到对应的接口，注意xml文件名和接口文件名要相同 ...
Caused by: org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.shsx
m0_52946104的博客
04-11 668
找了 好久 就这么个小问题 烦人
Caused by: org.apache.ibatis.binding.BindingException: Invalid bound statement (not found):
qq_46116922的博客
07-22 1073
先上图： 今天升级spring和gradle的版本遇到的这个问题，我的第一反应其实是没扫描到xml,但是同事不至于没测试就推代码到仓库了。我检查了，网上常见的几种问题： 命名空间错误 单词拼写错误 xml扫描 xml放在resource目录 以上问题，在我们的代码中式不存在错误的，而且我其他的同事都能正常跑起来代码。 所以，应该不是代码问题，我就检查了gradle的配置，果不其然，是idea配置gradel出现错误。 错误的gradle配置 修改后的gradle配置 2021-07-22 22:0
Mybatis中的Caused by: org.apache.ibatis.binding.BindingException: Invalid bound statement (not found):...
weixin_34126215的博客
11-13 220
1 首先在配置mapper-locations的时候： 　　classpath: 只在现有目录下寻找配置文件 　　classpath*: 在现有的项目目录下和依赖的jar包下寻找xml配置文件 转载于:https://www.cnblogs.com/zhaikaixuan/p/9951873.html...
spring boot 启动项目 加载不到 resources 目录下的配置文件或xml文件 解决方法
weixin_45876619的博客
10-03 3534
在POM 文件加如下配置即可 <build> <resources> // 加载不到 java 目录下的文件 配置 <resource> <directory>src/main/java</directory> <includes> <include>**/*.xml</include> .
mybatis提示Caused by: org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)错
weixin_43907628的博客
04-14 661
一、问题现象 二、原因分析 未在项目配置文件添加mybatis配置
springboot org.apache.ibatis.binding.BindingException: Invalid bound statement
风泊月
10-23 617
使用springboot整合mybatis 发现无法使用进行数据库操作 一直报绑定失败 springboot org.apache.ibatis.binding.BindingException: Invalid bound statement 检查后发现 编译后的文件没有xml文件 看到这里就明白了 需要资源拷贝插件 将xm文件 也进行编译 非常简单 在pom文件的build中 ...
【mybatis-plus配置】解决 org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)错误
weixin_54405369的博客
08-09 562
解决jar包运行项目mapper/*.xml文件加载失败的问题
Caused by: org.apache.ibatis.binding.BindingException: Parameter ‘xxx‘ not found. Available paramete
weixin_47698743的博客
10-10 1324
项目场景： 提示：这里简述项目相关背景： 例如：项目场景：示例:通过蓝牙芯片(HC-05)与手机 APP 通信，每隔 5s 传输一批传感器数据(不是很大) 问题描述： 提示：这里描述项目中遇到的问题： 例如：数据传输过程中数据不时出现丢失的情况，偶尔会丢失一部分数据 APP 中接收数据代码： @Override public void run() { bytes = mmInStream.read(buffer); mHandler.obta
Caused by: org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.zy.system.mapper.SysConfigMapper.selectConfigList
08-17
你遇到的异常是 MyBatis 中常见的错误之一： ``` Caused by: org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.zy.system.mapper.SysConfigMapper.selectConfigList ``` --- ## ✅ 异常含义 这个异常表示 MyBatis 在执行时找不到对应的 SQL 映射语句，即： - MyBatis 无法在 XML 文件或注解中找到 `com.zy.system.mapper.SysConfigMapper.selectConfigList` 这个方法对应的 SQL 语句。 --- ## ✅ 常见原因及解决方案 ### 1. Mapper 接口与 XML 文件未正确绑定 #### ✅ 检查点： - Mapper 接口的全限定名（包括包名）是否和 XML 文件中的 `namespace` 一致。 #### ✅ 示例： **SysConfigMapper.java** ```java package com.zy.system.mapper; import java.util.List; import com.zy.system.model.SysConfig; public interface SysConfigMapper { List<SysConfig> selectConfigList(); } ``` **SysConfigMapper.xml** ```xml <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="com.zy.system.mapper.SysConfigMapper"> <select id="selectConfigList" resultType="com.zy.system.model.SysConfig"> SELECT * FROM sys_config </select> </mapper> ``` > 注意：`namespace` 必须与接口的全限定类名一致。 --- ### 2. XML 文件未被正确加载到 MyBatis 配置中 #### ✅ 检查点： - XML 文件是否在 `resources` 目录下的正确路径中（如：`resources/mapper/SysConfigMapper.xml`）。 - MyBatis 配置文件中是否正确配置了 `mapperLocations`。 #### ✅ Spring Boot 配置示例（application.yml）： ```yaml mybatis: mapper-locations: classpath:mapper/**/*.xml type-aliases-package: com.zy.system.model ``` --- ### 3. Mapper 接口未被 Spring 管理 #### ✅ 检查点： - Mapper 接口是否使用了 `@Mapper` 注解或在启动类上使用了 `@MapperScan`。 #### ✅ 示例 1：使用 `@Mapper` ```java import org.apache.ibatis.annotations.Mapper; @Mapper public interface SysConfigMapper { List<SysConfig> selectConfigList(); } ``` #### ✅ 示例 2：使用 `@MapperScan`（推荐） ```java import org.mybatis.spring.annotation.MapperScan; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication @MapperScan("com.zy.system.mapper") public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` --- ### 4. 方法名拼写错误或大小写不一致 #### ✅ 检查点： - 接口方法名 `selectConfigList` 是否与 XML 中的 `id` 完全一致。 --- ### 5. 使用注解方式时未正确配置 SQL #### ✅ 示例： 如果你使用的是注解而不是 XML，应如下写法： ```java import org.apache.ibatis.annotations.Select; import java.util.List; public interface SysConfigMapper { @Select("SELECT * FROM sys_config") List<SysConfig> selectConfigList(); } ``` --- ## ✅ 调试建议 1. 打印 MyBatis 加载的 Mapper 列表： ```java @Autowired private SqlSessionFactory sqlSessionFactory; @PostConstruct public void printMappers() { Collection<String> mappers = sqlSessionFactory.getConfiguration().getMappedStatementNames(); mappers.forEach(System.out::println); } ``` 2. 检查日志输出中是否有： ``` Mapped Statements collection does not contain value for com.zy.system.mapper.SysConfigMapper.selectConfigList ``` --- ## ✅ 总结 | 原因 | 检查点 | |------|--------| | Mapper 接口与 XML namespace 不一致 | 检查 namespace 是否匹配 | | XML 文件未加载 | 检查 `mapperLocations` 配置 | | Mapper 接口未被扫描 | 使用 `@Mapper` 或 `@MapperScan` | | 方法名不一致 | 检查 `id` 和方法名是否一致 | | 使用注解但未配置 SQL | 检查是否使用了 `@Select` 等注解 | --- ##
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值