Invalid bound statement (not found)，对应mapper的某个方法（getUserInfo）未找到

最新推荐文章于 2025-11-12 12:46:44 发布

转载最新推荐文章于 2025-11-12 12:46:44 发布 · 634 阅读

JAVA 专栏收录该内容

93 篇文章

订阅专栏

本文介绍了一个关于MyBatis项目中Mapper XML文件未能正确加载的问题及其解决方案。问题表现为启动项目时报错，找不到指定的Mapper方法。通过配置Maven的资源过滤规则，确保XML文件能被正确复制到类路径下，最终解决了该问题。

一、问题描述

项目使用多个模块构建，其中 B模块依赖于A模块，A模块中有mapper 和对应的xml用于查询数据。但是启动项目之后，报如下错误：Invalid bound statement (not found): com.chinacaring.user.dao.mapper.UserMapper.getUserInfo

开始以为没有加上mapperscan 未扫描对应的mapper，后来加上后还是同样的问题。

二、原因和解决方法

原因在于和mapper相互绑定的 .xml文件不是代码，无需编译，但是需要指定在编译时将指定的资源文件（此处为 .xml文件）拷贝到对应目录下（此处应当为编译好之后类文件的对应目录）

在 pom中加入：

<build>
		<resources>
		<resource>
			<directory>src/main/java</directory>
			<includes>
				<include>**/*.xml</include>
			</includes>
		</resource>
		</resources>

	</build>

指定将 src/main/java目录下 匹配 **/*.xml格式的 文件 拷贝到 编译后的类文件相同目录下

不加之前 target的结构

加了拷贝资源的build之后

可见指定的xml资源文件被拷贝进来了，这样，再次运行就可以找到mapper所绑定xml文件，并执行相应的操作了

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

Adonis_D_Gogh

关注关注

1
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

Mybatis遇到问题（Invalid bound statement (not found)）

qq_45657986的博客

04-10

267

我的问题主要在mybatis配置文件中mappers注册这里 mybatis-config.xml 我这里使用了批量注册，可我的xml配置文件没有放在与DAO相同的路径下，路径可以不同，但是名称相同。解决方法第一步：将resrouse文件先修改为Test Source Root(这样做的目的是为了创建包的过程中，命名为com.fjn.mybatis.dao,它会自动生成一系列的子文件夹) 第二部：创建包包名为：com.fjn.mybatis.dao 它在资源管理器中的路径第三步：将你的xm.

MyBatis源码解析——SqlSession执行Mapper过程

qq_16500963的博客

10-19

1115

Mapper由两部分组成，分别为Mapper接口和通过注解或者XML文件配置的SQL语句。为了让读者有一个清晰的思路，笔者将SqlSession执行Mapper过程拆解为4部分介绍：首先介绍Mapper接口的注册过程，然后介绍MappedStatement对象的注册过程，接着介绍Mapper方法的调用过程，最后介绍SqlSession执行Mapper的过程。

参与评论您还未登录，请先登录后发表或查看评论

【疑难杂症】访问所有mapper方法都提醒invalid bound statement (not found)

最新发布

2509_94199376的博客

11-12

185

查看相对应的mapper中的接口是否添加了**@mapper注解**且点击其跳转标志确认是否关联。3.检查 mapper namespace的路径是否和其mapper实例类的路径是否一致。情况四：mapper.xml未放到指定的resource文件中，将其移动至其文件即可。

mapper.xml文件报Invalid bound statement (not found)错误解决方法

LM891108647的博客

08-06

6969

如果在使用mapper.xml时报了Invalid bound statement (not found)的错误，并且自己的mapper.xml的路径和文件名都没有错误的情况，很可能是因为没有在pom.xml中配置如下代码：  <resources> <resource...

问题解决：Invalid bound statement (not found): com.yoe.mapper.UserMapper

小汤圆

08-15

4592

在用Maven整合SSM项目的时候测试Demo发现报了这么一个错误： Invalid bound statement (not found): com.yoe.mapper.UserMapper 因为自己用的是Mybatis的逆向工程生成的Mapper接口和Mapper.xml，所以不存在Mapper接口和Mapper.xml名字不一致的问题，于是就上网搜解决方案，原来是Maven的问题。 Maven默认只识别src-main-resources下的资源文件，如果在maven工程中资源文件放在src-ma

MyBatis-Plus问题全覆盖：诊断"Invalid bound statement"异常的终极秘籍

本文旨在介绍和分析MyBatis-Plus框架中常见的"Invalid bound statement"异常，探讨其根本原因、触发场景以及诊断和处理方法。文章首先概述了MyBatis-Plus的优势和异常概览，接着深入到异常的根本

SpringBoot与MyBatis-Plus的整合与综合实例

pan_junbiao的博客

09-27

1603

MyBatis 是一款优秀的持久层框架，它支持定制化SQL、存储过程、以及高级映射。MyBatis3 提供的注解可以取代 XML。例如，使用注解 @Select 直接编写 SQL 完成数据查询。MyBatis-Plus 是一个对 MyBatis 进行增强的工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。

invalid bound statement (not found):找不到Mapper文件

ZhaoyuMing568的博客

11-23

745

标题问题复现:在调用mapper的时候报错错误体现:invalid bound statement (not found) 原因有很多在这里我贴出自己报错的原因,后续如果又遇到其他问题,再补充我是因为没有在pom.xml中配置将.xml文件打包到项目里,导致的找不到mapper文件,导致的报错在pom.xml中添加如下 <!-- 将所有的xml和properties都打包进项目,不...

在调用Mapper层方法时报错：Invalid bound statement (not found)

生如夏花之灿烂

01-17

6970

今天在一个正常的springmvc项目中，调用方法传递至service层时报错：Invalid bound statement (not found)，然后是一个方法没有找到。刚开始以为是参数类型的问题，Controller和Service层都是int型，Mapper层时Integer型，修改了之后还是依旧报错。后来请教同事发现可能是pom.xml中缺少一个配置来让classpath中src/...

Invalid bound statement (not found):mapper.method] with root cause

antan2013的博客

08-25

2519

Invalid bound statement (not found) … maven工程出现此问题时，按以下步骤检查一般就会解决问题： 1：检查xml文件所在package名称是否和Mapper interface所在的包名一一对应； 2：检查xml的namespace是否和xml文件的package名称一一对应； 3：检查方法名称是否对应； 4：检查包扫描是否能包含 5：去除xml文件中的中文...

Invalid bound statement (not found): com.java.mapper.UserMapper.queryAll错误解决方案

小汤圆

08-15

1485

Invalid bound statement (not found): com.java.mapper.UserMapper.queryAll错误今天在写代码的时候遇到了这个问题在网上试了好多方法都解决不了，最后发现是因为maybatis找不到mapper.xml文件最后在pom.xml中加入以下代码 <build> <resources> <resource> <directory>src/main/java&lt

Springboot 多模块项目使用mybatis-plus插件，调用sql时报错：Invalid bound statement (not found)

kongtong2004的专栏

07-19

3319

Springboot 多模块项目，整合mybatis-plus报错：Invalid bound statement (not found) ，困扰很久，网上也分析了很多原因及对应的解决方案。出现这个报错根本原因就是系统启动时未加载到mybatis xml映射文件或加载的xml配置文件有错误（比如调用的sql语法、格式错误等，可自行检查）。我的业务相关的xml映射...

访问mapper方法提示invalid bound statement (not found)原因总结

weixin_30617737的博客

08-13

1573

1.访问所有的mapper都报此错误，检查 mapper.xml 中的 namespace 2.访问mapper中的部分方法时报此错误，检查xml文件中的id是否和接口中的方法名一致 3.mapper接口中的方法返回值是List<User>,而select元素没有正确配置ResultMap,或者只配置ResultType 4.检查application.propertie...

Mybatis配置问题解决Invalid bound statement (not found)

weixin_30808693的博客

07-01

295

首先这个异常的原因是系统根据Mapper类的方法名找不到对应的映射文件。网上也搜索了到了类似的文章，一般可以从以下几个点排查： mapper.xml的namespace要写所映射接口的全称类名，而且要和Mapper类对应好！ mapper.xml中的每个statement的id要和接口方法的方法名相同 mapper.xml中定义的每个sql的parameterType要和接口方法的形...

Invalid bound statement (not found): com.test.mapper.UserMapper.selectByPrimaryKey

weixin_42067668的博客

09-17

1129

最近学习shiro，将how2j的项目下载下来跑的时候。显示jdk太高，跑去下了一个jdk，然后又遇到了这个问题，原因是因为xml文件springboot是不会编译的，那就需要放在resouce目录下，放了之后就需要修改的位置，改成就好了， ...

springboot整合mybatis错误 Invalid bound statement (not found): com.yuan.mapper.UserMapper.getUserList

小汤圆

08-15

478

出现的原因是 src文件下的mapper有mapper接口和映射文件，而target下的mapper文件却没有映射文件 =解决方案======== 1.把映射文件放到resources 目录下结构目录一模一样 2.在pom.xml中导入以下代码 <build> <resources> <resource> <directory>src/main/java</directory&g

Invalid bound statement (not found)四步解决问题

程序员小明1024

11-04

3297

报错日志 Invalid bound statement (not found)报错原因，mapper文件与mapper.xml文件未绑定解决1、查看mapper.xml中的namespace和实际的mapper文件是否一致2、查看mapper接口中的方法名和mapper.xml中的id标签是否一致3、查看target中对应的mapper.xml文件是否存在4、添加依赖构建xml等资源文件（cle...

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> ``` --- ###