找不到mapper映射文件异常：Invalid bound statement (not found)

最新推荐文章于 2025-06-18 00:26:59 发布
最新推荐文章于 2025-06-18 00:26:59 发布
阅读量1.7w 收藏 1
点赞数 3
CC 4.0 BY-SA版权
分类专栏： 常见的异常处理 文章标签： mybatis java 异常处理
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/Qxiaonan/article/details/79429782
本文介绍了一个常见的MyBatis问题：项目运行时报错找不到映射文件。通过检查发现只存在mapper接口而没有对应的XML文件。文章提供了解决方案，在pom.xml文件中加入资源文件配置，确保XML映射文件能够被正确加载。

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

先粘贴报的异常代码


这个异常是在mybatis项目中，找不到项目的映射文件。但是我项目中的mapper文件是用mybatis的逆向工程生成的按理说应该存在。我到了项目的文件夹中找了下，确实不存在mapper的映射文件，只有mapper的接口。


此时需要在***mapper的pom.xml文件中添加配置节点代码（我的项目是maven构建的），如果不配置，mybatis的mapper.xml文件都会被漏掉。

<!-- 如果不添加此配置，mybatis的mapper.xml文件都会被漏掉 -->
  <build>
           <resources>
                <resource>
                   <directory>src/main/java</directory><!--所在的目录-->
                   <includes><!--包括目录下的.properties,.xml文件都会扫描到-->
                     <include>**/*.properties</include>
                      <include>**/*.xml</include>
                   </includes>
                   <filtering>false</filtering>
                </resource>               
           </resources>
  </build>
这样重新启动服务就ok了！



invalid bound statement (not found):找不到Mapper文件
ZhaoyuMing568的博客
11-23 723
标题 问题复现:在调用mapper的时候报错 错误体现:invalid bound statement (not found) 原因有很多 在这里我贴出自己报错的原因,后续如果又遇到其他问题,再补充 我是因为没有在pom.xml中配置将.xml文件打包到项目里,导致的找不到mapper文件,导致的报错 在pom.xml中添加如下 &lt;!-- 将所有的xml和properties都打包进项目,不...
报错 Invalid bound statement (not found) 找不到对应的mapper
暗夜蝶梦
05-27 462
搜了好多，发现，只是因为pom.xml引用的依赖在配置文件中配置的不对应导致的 引用 mybatis-plus 包 <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus</artifactId> <version>3.1.0</version> </dependency> mybatis.mapper-loca
IntelliJ IDEA：Invalid bound statement (not found)
qq_56486237的博客
06-18 584
IntelliJ IDEA：Invalid bound statement (not found)
Invalid bound statement (not found) 找不到mapper 映射文件异常
aozhe0629的博客
08-20 165
访问页面报如下错（注意第一行后面的 invalid bound statement (not found)） 这时候再mapper的pom.xml文件要加如下。 否则该节点mybatis的mapper.xml会被漏掉 <build> <resources> <resource> ...
java.lang.RuntimeException: org.apache.ibatis.binding.BindingException: Invalid bound statement (not
sajdkla的博客
09-26 617
1、检查 mapper.xml 中 namespace 等于是否与mapper接口地址一致 mapper.xml： <?xml version="1.0" encoding="UTF-8"?> select * from order where code = #{code} 2、检查mapper.java 接口中的方法名和 mapper.xml 中的sta...
构建Spring Boot简单项目报错： Invalid bound statement (not found)【找不到mapper文件】【找不打mapper中所有的方法】
双非二本自学到互联网公司的成长经历，有故事，有干货。
06-07 904
问题背景 目的是构建一个Spring Boot工程，连接本地数据库，进行SQL方面的研究。构建过程遇到两个问题，随笔记下。 问题描述 问题一: 启动项目时，找不到mapper文件（项目直接起不来，如下图） 问题二：启动项目后，访问Controller中方法时报500（如下图） 解决思路 问题一： 首先mapper文件其实是接口（interface）对应的实现类，通常这两个文件与对应的pojo都不是我们手动去写的，而是通过mybatis的一款插件generator来生成的。所以注意力不应该放在这三个类
MyBatis配置文件找不到Mapper映射文件
chenzeyun37的博客
06-07 2298
MyBatis配置文件找不到Mapper映射文件
Invalid bound statement (not found) 找不到mapper映射文件
score_1的博客
03-14 409
在原有微服务项目中添加新模块，使用IDEA运行新模块主方法，发现target下没有mapper.xml，并且访问网页时报错：Invalid bound statement (not found) 即找不到mapper映射文件。文件夹中没有构建相应的xml文件。上面的配置文件的指定别名包。文件夹中存在 相应的。和我本地的包名不一致。
maven配置文件无法导出或生效问题
weixin_42507750的博客
02-25 349
maven配置文件无法导出活生效问题 解决办法 <!--在build中配置resources,来防止我们资源导出失败的问题--> <build> ... <resources> <resource> <directory>src/main/resources</directory> <excludes>
Invalid bound statement (not found):mapper文件找不到错误
热门推荐
Demo_Liu的博客
08-06 3万+
在用IDEA并使用Mybatis的时候,IDEA并不能默认将Mapper.xml文件加载到测试包下,所以会报文件找不到的错误,所以需要在pom文件中加入以下代码,添加在&lt;build&gt;&lt;/build&gt;中 &lt;resources&gt; &lt;resource&gt; &lt;directory...
Invalid bound statement (not found): 某个Mapper下的方法找不到
m0_37626203的博客
11-16 830
在使用Maven多模块时，集成Mybatis。出现了如上述问题.本质原因是 配置的Mapper并没有加载进去。 解决方式： mybatis:mapper-locations: classpath:mapper/*.xml 在application.yml中添加上述配置完成即可。这是大多数的问题所在。当我如上述配置时并没有解决问题。在此处有两个其他人的问题，我试了一下在我项目中并不存在. ...
mybatis运行时找不到对应的mapper映射文件
wen13727561564的博客
05-09 966
但运行时就会报org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): com.wenpopo.mybatis.mapper.StudentMapper.getStudentAndSuNoByStudentId错误，创建com.wenpopo.mybatis.mapper.UserMapper.class文件后。发现都是没有问题的，最后我想起来在resources创建的不是软件包，而是目录，
使用mybatis时报错，mapper.xml中的方法找不到：Invalid bound statement (not found)
weixin_42875302的博客
12-20 920
mapper.xml中的方法找不到：Invalid bound statement (not found) 试了网上的这些方法，发现都不起作用 最终用了下面的方法才解决了 1.1 若是mapper.xml文件放置在resource目录下，则在application.properties配置 1.2 若mapper.xml文件放置在java目录下，则在application.properties配置的同时还要在pom.xml里配置 ...
SSM框架整合时提示找不到mapper映射文件
Tommy5553的博客
04-26 1672
参考：https://www.cnblogs.com/rgever/p/9360314.html SSM整合时报错： Invalid bound statement (not found): com.share.manager.mapper.TbItemMapper.selectByExample 原因是没有加载mapper.xml文件 解决方法：在mapper工程下的pom文...
找不到mapper的解决方案
2301_79779756的博客
04-29 3911
在Java开发过程中，特别是在使用MyBatis这样的ORM框架时，我们经常会遇到“找不到mapper”的错误。Mapper通常指的是MyBatis中用于映射数据库操作到Java方法的接口。当框架无法定位到相应的Mapper接口或者映射文件时，就会抛出这样的错误。这通常是由于配置不当、路径错误或扫描包不正确等原因导致的。
【MyBatis】MyBatis找不到mapper文件
阳阳的博客
08-04 2万+
MyBatis找不到mapper文件 用的Idea，在写MyBatis时，测试发现有以下的报错信息 Error parsing SQL Mapper Configuration. Cause: java.io.IOException: Could not find resource dao/PersonMapper.xml ...
Mybatis映射异常：Invalid bound statement (not found)
wangtaojiushiwo的博客
03-03 1349
环境说明：WINDOWS本地 + IDEA + gradle + mapper与xml文件都放在一个包下 问题背景： 项目启动的时候，会去数据库查询一些配置信息，但是只要涉及到sql 的执行，就会报错：Invalid bound statement (not found) 很明显，这是mybatis的mapper与xml文件绑定异常 定位思路： 这时候可以检查下mapper的路径是否一致，命名是否一致等等 我这里很显然不是这样的原因，那既然报错信息是绑定异常，not found 会不会是xml文件压
MyBatis-Plus找不到Mapper.xml文件，解决方法
web18334137065的博客
03-22 1657
MyBatis-Plus找不到Mapper.xml文件 1.原因1： 原因2： 原因3： 1.原因1： Mapper的命名空间和Dao层的接口。此种原因的解决方法为将命名空间和接口名一致。 原因2： maven的配置 检查下pom所用的jar包。 mybatis-plus包和mybatis包别搞混了 mybatis -plus的配置为 pom为 原因3： Mapper.xml的位置是在java目录下，而非resource目录下。 此处需加收进行扫描 <resources>
java mapper 映射 invalid bound statement not found
最新发布
07-02
### 三级标题：问题分析 `Invalid bound statement (not found)` 是 MyBatis 或 MyBatisPlus 中常见的错误，表示无法找到对应的 Mapper 映射语句。这种问题通常与以下几方面有关： 1. **Mapper 接口与 XML 文件未正确绑定** Mapper 接口中定义的方法名必须与 XML 文件中 `<select>`, `<insert>`, `<update>`, `<delete>` 标签的 `id` 属性完全一致，包括大小写和拼写 [^4]。 2. **XML 文件路径配置不正确** 如果 Mapper XML 文件放置在 `resources` 目录下，则需要在配置文件（如 `application.yml` 或 `application.properties`）中指定正确的映射文件路径。例如： ```yaml mybatis: mapper-locations: classpath:/mapper/**/*.xml ``` 或者多个路径使用逗号分隔 [^4]。 3. **构建过程中 XML 文件未被正确打包到 target/classes 下** 在 Maven 项目中，如果 XML 文件没有放在 `src/main/resources` 路径下，而是放在了其他位置（如 `static` 目录），则不会被复制到编译输出目录中，导致运行时找不到文件 [^3]。应确保 XML 文件位于资源目录中，并且在 `pom.xml` 中配置资源过滤： ```xml <build> <resources> <resource> <directory>src/main/resources</directory> <includes> <include>**/*.xml</include> </includes> </resource> </resources> </build> ``` 4. **MyBatis 配置文件中缺少必要的组件注册** 如果使用了自定义类型处理器（TypeHandler），需要在 `mybatis-config.xml` 文件中注册该处理器，否则可能导致某些内置方法失效。示例配置如下： ```xml <configuration> <typeHandlers> <typeHandler handler="com.example.handler.JSONTypeHandler"/> </typeHandlers> </configuration> ``` 同时，在 Spring Boot 中还需要通过 `@MapperScan` 注解扫描 Mapper 接口所在的包 [^2]。 5. **Mapper 接口未被 Spring 管理或未正确注入** 检查是否为 Mapper 接口添加了 `@Mapper` 注解，或者是否在启动类上使用了 `@MapperScan` 来自动扫描所有 Mapper 接口 [^1]。 6. **模块依赖关系未正确配置** 在多模块项目中，新添加的模块可能没有正确引用包含 Mapper 的父模块或公共模块，导致运行时无法加载相关资源。检查 `pom.xml` 或 Gradle 构建文件中的依赖关系，确保模块间依赖配置正确 [^1]。 --- ### 三级标题：解决方案总结 以下是解决 `Invalid bound statement (not found)` 错误的关键步骤： 1. **确认接口方法与 XML 中的 id 一致** - 检查大小写、拼写是否完全匹配。 - 确保每个方法都有对应的 SQL 定义。 2. **检查 XML 文件路径并配置 mapper-locations** - 将 XML 文件放在 `resources/mapper/` 或类似结构化路径下。 - 在 `application.yml` 或 `application.properties` 中配置正确的路径： ```yaml mybatis: mapper-locations: classpath:/mapper/**/*Mapper.xml ``` 3. **确保 XML 文件被正确打包到 target/classes** - 避免将 XML 文件放在 `static` 等非资源目录。 - 配置 `pom.xml` 中的 `<resources>` 部分以确保 XML 文件被包含进构建流程 [^3]。 4. **注册自定义 TypeHandler（如有）** - 在 `mybatis-config.xml` 中添加 `<typeHandlers>` 配置。 - 确保不影响 MyBatis 自带方法的正常使用 [^2]。 5. **检查 Mapper 扫描配置** - 使用 `@Mapper` 注解单个接口或使用 `@MapperScan` 批量扫描接口。 - 确保启动类所在包能覆盖所有 Mapper 接口 [^1]。 6. **处理多模块项目的依赖问题** - 确认新模块已正确引入包含 Mapper 和 XML 文件的模块。 - 查看 `target` 输出目录中是否存在 `.xml` 文件 [^1]。 --- ### 三级标题：示例代码 #### 示例一：MyBatis 配置文件 `mybatis-config.xml` ```xml <configuration> <typeHandlers> <typeHandler handler="com.example.handler.JSONTypeHandler"/> </typeHandlers> </configuration> ``` #### 示例二：Spring Boot 应用主类 ```java @SpringBootApplication @MapperScan("com.example.mapper") public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` #### 示例三：Mapper 接口 ```java @Mapper public interface UserMapper { @Select("SELECT * FROM user WHERE id = #{id}") User selectById(Long id); } ``` #### 示例四：Mapper 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.example.mapper.UserMapper"> <select id="selectById" resultType="com.example.entity.User"> SELECT * FROM user WHERE id = #{id} </select> </mapper> ``` --- ###
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值