IDEA Invalid bound statement (not found) 工具引起

最新推荐文章于 2025-07-14 22:44:22 发布
原创 最新推荐文章于 2025-07-14 22:44:22 发布 · 378 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#java #spring #eclipse

本文记录了一位开发者在使用IDEA与MyBatis Plus开发微服务项目时遇到的包结构问题，详细描述了从发现问题、排查原因到最终解决的过程，揭示了IDEA与其他IDE在处理包结构上的差异。 
今天在开发项目时遇到了一个让我翻车坑, 具体是什么呢?让我来描述一下啊, 最近在做一个新项目-中台服务系统采用的是微服务架构, 框架新搭建的, 为了快捷开发,我们采用了springboot+mybatisPlus中的代码生成器, 由于我做的一个微项目中涉及到的业务非常复杂,为避免后期会涉及到个别表结构的改动, 因此没有一次生成此微项目所有涉及到的业务表对应的代码, 包名是自己创建的, 这就是问题背景5555
以下开始讲述问题情况
在开发过程中大部分方法都是尽量用mybatisPlus中Wrapper这种可以对表进行操作的方式, 直到这里编写代码自测都是没有问题的, 当业务中不得不是用多表关联时, 自定义编写了一个方法,自测时报bug出现了

调用BaseMapper出现Invalid bound statement (not found)错误

当时就很诧异, 怎么可能?其他功能都没问题,为什么自己编写的会这样?很明显这个bug的意思是找不到, 解决这种问题,我也就不赘述了, 常规来说加扫描注解, 查看路径等等肯定可以搞定, 于是我查看了各个可能导致这个问题的代码及配置例如

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

这是我所创建的目录结构,别问为什么要直接写两层包, 统一规范.

核对之后发现没有问题啊, 然后再别的微项目中写一个自定义方法, 没有问题,可以调用,那说明不是整体架构的问题,只是我这个微服务的问题,然后打开其他项目,在结构上一一对比,还是一模一样, 搞不懂啊,最后打算看看是不是编译的时候包没有生成呢?解压生成的包target文件, 发现了该问题,哎呀,这个包怎么变成一个啦?应该是两层啊!此时找到问题,将mapper.product改成mapper/product问题解决了.
在这里插入图片描述

虽然问题解决了, 但还是存在疑问啊,工作这么多年了,怎么会出现这种问题呢?两个包怎么就变成一个包了呢?必须刨根啊, 于是又创建了几个二层包文件,用原点间隔与用斜杠间隔的确是不一样,但是以前用原点间隔就是建立多层包文件啊,不可能出现错误啊,嗯,可能是工具的问题, 以前用的是eclipse, STS等, 现在使用的是Idea, 是不是IDEA这个工具引起的呢?试一下,找出以前使用的工具STS,创建项目创建包,果然如此,不允许使用斜杠,原点间隔出层级,到此问题找到了,什么原因引起的也找到了,IDEA中创建包名可以包含原点,用斜杠分隔包层,还是感觉有点坑啊,因为这么个问题花了一个多小时啊,最可气的是IDEA工具中看文件目录是一样的,也不像STS和eclipse那样表示包文件时会有个三角的角标用于区分.

在这里插入图片描述
小小一个问题罗里吧嗦说了这么多, 嗯, 主要是记录一下, 也是提供一下我解决这个问题时的一个思路吧!逐层深入,逐级排查

此时还有另一个疑问需要确认, 那就是为什么使用mybatisPlus代码生成器生成的代码就能找到文件并且请求运行等等都是没有问题的呢?!而自己创建的扫描就不可以呢?那应该是扫描与处理机制不一样吧?可能根本就没不需要 xml文件一样可以使用吧?!, 下次查一下资料确认一下

MyBatis报错Invalid bound statement (not found)
邓邓子的博客
02-20 741
问题 引入 Mybatis 编译时报错 Invalid bound statement (not found)： 2022-02-20 15:51:01.650 ERROR 95884 --- [nio-8080-exec-4] o.a.c.c.C.[.[.[/].[dispatcherServlet] : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request
（最全详解）idea项目报错：Invalid bound statement (not found): com.android.mapper.ClientMapper......
ABzqy的博客
08-06 5949
在报这个错误是因为构建后没有没有.xml文件 具体原因排查如下五种总有一个适合你（我是第五个原因）： 1、访问所有的mapper都报此错误，检查 mapper.xml 中的 namespace 2、访问mapper中的部分方法时报此错误，检查xml文件中的id是否和接口中的方法名一致 3、mapper接口中的方法返回值是List<User>,而select元素没有正确配置ResultMap,或者只配置ResultType 4、检查application.prope...
idea报错：Invalid bound statement (not found)
weixin_30835649的博客
10-23 309
在配置MyBatis接口映射的Mapper.xml时，提示Invalid bound statement (not found)异常，就算是接口和xml名字相同，路径相同也无法找到，在网上找到了几种解方案。 idea默认不扫描src/main/java 下的xml文件，想要放在同一目录下，需要在pom.xml中配置扫描java目录下的xml即可，在build节点下添加： <resour...
Mybatis - 在idea中错误：Invalid bound statement (not found)
02-22 282
如果使用的是Eclipse，Eclipse的src目录下的xml等资源文件在编译的时候会自动打包进输出到classes文件夹。学习mybatis的过程中，测试mapper自动代理的时候一直出错，在eclipse中可以正常运行，而同样的代码在idea中却无法成功。IDEA的maven项目中，默认源代码目录下的xml等资源文件并不会在编译的时候一块打包进classes文件夹，而是直接舍弃掉。--这里进行配置，后会自动的加载mapper.xml文件　:配置Maven 对resource文件 过滤 -->
IDEA报错： Invalid bound statement (not found)
Heizer的博客
03-01 732
原因： IDEA的maven项目中，默认源代码目录下的xml等资源文件并不会在编译的时候一块打包进classes文件夹，而是直接舍弃掉。 如果使用的是Eclipse，Eclipse的src目录下的xml等资源文件在编译的时候会自动打包进输出到classes文件夹。 解决方法 maven对应配置文件的标签对中添加如下设置 &lt;!--配置Maven 对resource文件 过滤 --&gt;...
idea出现Invalid bound statement (not found)---问题解决
acwing的博客
02-11 4504
Invalid bound statement (not found) 报错截图 ![在这里插入图片描述](https://img-blog.csdnimg.cn/4629bca1b0d6452ea574883b04ac96ca.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow_50,text_Q1NETiBAYWN3aW5n,size_20,color_FFFFFF,t_70,g_se,x_16 出现这类的错误主要是就是检查自己的
解决 MyBatis 报错：Invalid bound statement (not found) 全方案
最新发布
2301_79533973的博客
07-14 3054
摘要：本文针对SpringBoot整合MyBatis时常见的"Invalid bound statement"错误进行了系统分析，指出该问题的本质是MyBatis无法找到对应的SQL映射语句。文章详细梳理了六大常见原因及解决方案：1）Mapper.xml的namespace配置错误；2）接口方法与XML标签id不匹配；3）实体类别名配置问题；4）Maven资源过滤缺失；5）XML文件存放路径不当；6）编译结果验证。同时提供了高级排查技巧，包括启用调试日志、使用@MapperScan注解等
MyBatis绑定错误提示BindingException:Invalid bound statement (not found)的解决方法
08-31
在使用MyBatis框架进行开发时，可能会遇到一个常见的错误：`BindingException: Invalid bound statement (not found)`。这个错误通常意味着MyBatis无法找到你在Mapper接口中声明的方法与XML映射文件中对应的SQL语句...
解决问题：访问BaseMapper中的方法报这个Invalid bound statement (not found)
weixin_61769871的博客
12-26 1316
检查自己pom中mybatis的依赖和mybatisplus的依赖的版本是否冲突，我这里解决的办法是把mybatis的依赖都注释掉，将mybatis-plus-boot-starter的依赖也注释掉。4、mvn clean，重启项目后就可以正常访问BaseMapper中的接口了。3、启动类上别忘了加mapper包路径扫描的注解。2、当然配置文件中xml路径的这个配置也不能少。
eclipse项目导入idea中报错Invalid bound statement (not found)
weixin_41218318的博客
03-02 543
提示：文章写完后，目录可以自动生成，如何生成可参考右边的帮助文档 目录前言一、报错原因？二、解决方法！运行成功 前言 eclipse项目导入idea中报错Invalid bound statement (not found) 提示：以下是本篇文章正文内容，下面案例可供参考 一、报错原因？ IDEA：maven项目中，默认源代码目录下的xml等资源文件并不会在编译的时候一块打包进classes文件夹，而是直接舍弃掉。 Eclipse：编译项目时会将src目录下的xml等资源自动打包加载到classes文
Mybatis在idea中错误：Invalid bound statement (not found)
日月忽其不淹兮，春与秋其代序 认知即成长
06-26 437
1.项目在eclipse中可以正常运行 2.IDEA的maven项目中，默认源代码目录下的xml等资源文件并不会在编译的时候一块打包进classes文件夹，而是直接舍弃掉。 如果使用的是Eclipse，Eclipse的src目录下的xml等资源文件在编译的时候会自动打包进输出到classes文件夹。 解决方法：将xml或properties文件 放到resource目录下 注意使用ID
解决IDEA中 Invalid bound statement (not found):的问题
热门推荐
yixuan30的博客
04-02 2万+
最近学习springboot的开发，中间磕磕碰碰也是遇到了诸多问题，以前编写java IDE都是用的eclipse，现在换成idea了倒有点不适应，中间遇到了一个让人很郁闷的问题，如下： 看到这个问题以后，首先想到的是不是自己的Controller写的有问题，写个测试类测试了一下，发现不是接口的问题，在网上搜了一下，是Controller层实现类未添加注解@Autowired。@Autowi...
IDEA报Invalid bound statement (not found)错误解决办法
白面小生的博客
10-14 2万+
我在配置ssm框架时，对service层测试报出了这个异常，遂百度查了一些 解决方法，以下转发借鉴博客 转自:https://blog.youkuaiyun.com/zsy3313422/article/details/52594082#comments 解决方法如下： 1、将*Mapper.xml文件夹放在resource文件夹下，但是这种方式会打破原来的代码结构，如果团队中有人用eclipse有人用...
关于idea 中使用mybastis报出 Invalid bound statement (not found)的错误解决方案
fu_jian_ping的博客
01-09 594
在实际项目，搭建mybatis会爆出 org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): 这个错误非常的头疼，如图1，不知道为什么mybatis就是找不到对应的xml文件。博主整理了三种可能的情况，三种情况下肯定有一种能帮助到你。 情况一：mapper.xml没有按照传统的maven架构...
IDEA+Maven:invalid bound statement (not found)那些微小的细节
hu961691590的专栏
04-19 302
IDEA+Maven的springboot项目，遇到一个invalid bound statement (not found)。 经过查资料网上文章大致分为4类问题： 1.mapper的namespace写的不对！！！注意系修改。（ctrl+左键能跳到mapper.java文件这个就可以排除） 2.UserDao的方法在UserDao.xml中没有，然后执行UserDao的方法会报此mapper的namespace写的不对！！！注意系修改。（在另外几种方法都试过无效后，请在重试此条，即复制粘贴map.
新版IntelliJ IDEA中Mybatis报Invalid bound statement (not found)错误解决办法
anjing821112的博客
09-20 5907
由于新版的IntelliJ IDEA不再编译source folder下的xml文件，而我们平时使用mybatis时，习惯于将*Mapper.xml文件放在与dao层、service层平级的src目录下。这就导致ItelliJ IDEA不会变异这些xml文件夹，从而导致Invalid bound statement (not found)的发生。 解决方法如下： 1、将*Mapper...
IDEA中报错 Invalid bound statement (not found)的解决方法
Leslie-心蓝
01-18 2962
Spring拥有自己的Mapper批量扫描器类，用于扫描Mapper代理借口。这个Mapper批量扫描器类，会从mapper包中扫描mapper接口，自动创建代理对象并且在Spring容器中注入。 这里遵循的规范是让XXXMapper.java和mapper映射文件名保持一致，且在一个目录内。 当使用MyEclipse时这样是没有问题的，但是当使用IDEA时，就会报 Invalid bound s...
IDEA中 Invalid bound statement (not found)解决方法
Life's a struggle
10-17 1740
Mybatis的mappers映射配置中，一般都会使用批量加载mapper，如：<mappers> <package name="com.ztq.mapper" /> </mappers>指定mapper接口的包名，mybatis自动扫描包下边所有mapper接口进行加载。遵循一些规范： 需要将mapper接口类名和mapper.xml映射文件名称保持一致，且在一个目录中上边规范的前提是：
mybatisplu访问方法时invalid bound statement not found
07-05
### 三级标题：问题原因分析 在使用 MyBatis-Plus 时遇到 `Invalid bound statement (not found)` 错误，通常是因为 MyBatis 无法找到对应的 SQL 映射语句。具体到 `xxxMapper.selectById` 这个方法，其本质是由于 XML 文件中没有定义名为 `selectById` 的 SQL 语句，或者接口与 XML 文件中的命名不一致 [^1]。 此外，该错误也可能发生在调用 `super.listByIds(userIdList)` 方法时，因为 `listByIds` 方法依赖于 `selectById` 来构建查询逻辑，如果找不到这个 SQL 映射，则会抛出异常 [^3]。 ### 三级标题：解决方法 #### 检查 Mapper 接口与 XML 文件的对应关系 确保接口中声明的方法名与 XML 文件中的 `<select>`、`<insert>`、`<update>` 或 `<delete>` 标签的 `id` 属性完全匹配。例如： ```java // Mapper 接口 User selectById(Long id); ``` XML 文件应包含如下内容： ```xml <select id="selectById" resultType="com.example.demo.entity.User"> SELECT * FROM user WHERE id = #{id} </select> ``` 若名称不一致或缺少该 SQL 定义，MyBatis 将无法绑定正确的 SQL 语句 [^4]。 #### 确保 XML 文件被正确加载 检查 Spring Boot 配置文件（如 `application.yml` 或 `application.properties`）是否指定了正确的 mapper XML 路径。典型的配置如下： ```yaml mybatis-plus: mapper-locations: classpath*:mapper/**/*.xml ``` 如果实际路径结构不符合配置中的通配符规则（如文件夹嵌套层级不正确），则会导致 XML 文件未被正确加载 [^5]。 #### Maven 项目资源过滤配置 对于 Maven 项目，需要确保 `pom.xml` 中包含了对资源目录下 `.xml` 文件的处理规则。否则，编译过程中 XML 文件可能不会被复制到最终的 `target/classes` 目录中，导致运行时找不到 SQL 映射。添加如下配置以确保资源被正确处理： ```xml <build> <resources> <resource> <directory>src/main/resources</directory> </resource> <resource> <directory>src/main/java</directory> <includes> <include>**/*.xml</include> </includes> </resource> </resources> </build> ``` 此配置将确保 Java 包下的 XML 文件也被识别并打包进应用中 [^4]。 #### 使用注解方式替代 XML 如果你更倾向于使用注解而非 XML 文件来定义 SQL 语句，可以直接在接口方法上添加相应的注解，例如： ```java @Select("SELECT * FROM user WHERE id = #{id}") User selectById(Long id); ``` 这种方式避免了 XML 文件路径和命名的问题，并且可以快速验证 SQL 是否生效 [^2]。 ### 三级标题：调试建议 1. **启用 MyBatis 日志输出** 在配置文件中开启 MyBatis 的日志功能，可以帮助定位具体的 SQL 加载情况： ```yaml logging: level: com.example.demo.mapper: debug ``` 2. **检查 Mapper 扫描路径** 确保 `@MapperScan` 注解指向了正确的包路径，以便 Spring Boot 可以扫描到所有的 Mapper 接口。 3. **IDE 缓存问题** 有时 IDE（如 IntelliJ IDEA）可能会缓存旧的配置或类文件，清理项目并重新构建可以排除此类干扰。 ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值