<think>我们正在解决一个特定的错误：在Spring Boot中使用MyBatis时遇到的`org.apache.ibatis.binding.BindingException
: Invalid bound statement (not found): com.web.hospital.mapper.UserMapper.findAllStage`。这个错误通常表示MyBatis无法找到与Mapper接口方法对应的SQL映射（可能是XML文件中的SQL语句，或者是注解方式写的SQL）。
根据引用内容，我们可以总结出以下常见原因及解决方案：
### 错误原因分析
1. **XML映射文件未正确加载**：Mapper接口中声明的方法（如`findAllStage`）在对应的XML文件中没有定义，或者XML文件没有被正确放置在资源目录下，导致编译时没有被复制到`target/classes`目录中。
2. **XML文件中的namespace或id错误**：XML映射文件的`namespace`属性没有设置为Mapper接口的全限定名，或者SQL语句的`id`与方法名不一致。
3. **MyBatis配置问题**：在`application.yml`或`application.properties`中配置的`mybatis.mapper-locations`路径不正确，无法扫描到XML文件。
4. **Mapper接口未被扫描**：没有使用`@Mapper`注解或在启动类上使用`@MapperScan`指定扫描包，导致MyBatis无法创建接口的代理对象。
5. **编译问题**：IDE（如IntelliJ
IDEA）在编译时可能没有将XML文件复制到`target/classes`目录（引用[4]提到的问题）。
6. **依赖冲突**：项目可能引入了多个MyBatis相关的依赖（如同时引入了MyBatis和MyBatis-Plus），导致冲突（引用[3]展示了依赖配置）。
### 解决方案
#### 1. 检查XML文件位置和内容
- **位置**：确保XML文件位于`resources`目录下，且路径与Mapper接口的包名对应（或符合`mybatis.mapper-locations`的配置）。例如，如果Mapper接口是`com.web.hospital.mapper.UserMapper`，那么XML文件可以放在`resources/com/web/hospital/mapper/UserMapper.xml`，或者统一放在`resources/mapper`目录下（此时需要在配置中指定`mybatis.mapper-locations=classpath
:mapper/*.xml`）。
- **内容**：检查XML文件中的`namespace`是否为Mapper接口的全限定名，并且SQL语句的`id`是否与方法名一致。例如：
```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.web.hospital.mapper.UserMapper">
<select id="findAllStage" resultType="...">
SELECT * FROM ...
</select>
</mapper>
```
#### 2. 检查MyBatis配置
在`application.yml`中确认：
```yaml
mybatis
:
mapper-locations
: classpath
:mapper/*.xml # 确保路径匹配
type-aliases-package
: com.web.hospital.entity # 实体类包
```
#### 3. 确保Mapper接口被扫描
- 在Mapper接口上添加`@Mapper`注解：
```
java
@Mapper
public interface UserMapper {
// ...
}
```
- 或者在启动类上添加`@MapperScan`：
```
java
@SpringBootApplication
@MapperScan
("com.web.hospital.mapper"
)
public class HospitalApplication {
public static void main
(String[] args
) {
SpringApplication.run
(HospitalApplication.class, args
);
}
}
```
#### 4. 检查编译后的target目录
- 清理项目并重新构建（`mvn clean install`或Gradle的相应命令）。
- 检查`target/classes`目录下是否有对应的XML文件。如果没有，可能是构建配置问题。对于
Maven项目，可以在`pom.xml`中确保资源文件被包含：
```xml
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.xml</include>
</includes>
</resource>
</resources>
</build>
```
#### 5. 检查依赖冲突
- 确保只引入了一个MyBatis启动器。如果使用MyBatis-Plus，则应该使用`mybatis-plus-boot-starter`，而不是原生的`mybatis-spring-boot-starter`（引用[3]展示了MyBatis-Plus的依赖）。
- 检查依赖树，排除冲突的版本：
```bash
mvn dependency
:tree
```
#### 6. 检查方法名和参数
- 确保Mapper接口中的方法名与XML中的`id`完全一致（包括大小写）。
- 如果使用注解方式，确保方法上有`@Select`等注解，并且SQL正确。
### 总结步骤
1. **检查XML文件是否存在且路径正确**。
2. **检查XML文件内容（namespace和id）**。
3. **检查MyBatis配置（mapper-locations）**。
4. **确保Mapper接口被扫描（@Mapper或@MapperScan）**。
5. **重新构建项目并检查target目录**。
6. **检查依赖，避免冲突**。
### 相关问题
1. MyBatis中如何配置多数据源？
2. MyBatis-Plus相比原生MyBatis有哪些优势？
3. 如何实现MyBatis的二级缓存？
4. MyBatis动态SQL的常用标签有哪些？
通过以上步骤，应该能够解决`BindingException`问题。如果问题仍然存在，可以进一步检查日志或提供更多信息。</think>### 解决 MyBatis 报错：
Invalid bound statement (not found)
该错误表示 MyBatis 无法找到 Mapper 接口方法对应的 SQL 映射。以下是完整解决方案：
#### 一、核心原因分析
1. **XML 映射文件未加载**（最常见原因）
- XML 文件未放入 `resources` 目录
- 编译后 XML 未复制到 `target/classes`（IDE 特定问题）[^4]
- `mybatis.mapper-locations` 配置路径错误
2. **映射配置不一致**
- XML 中 `namespace` 与 Mapper 接口全限定名不匹配
- SQL 语句 `id` 与方法名不一致
- 方法参数类型不匹配
3. **扫描问题**
- 缺少 `@Mapper` 或 `@MapperScan` 注解
- 扫描包路径配置错误
4. **依赖冲突**
- 同时存在 MyBatis 和 MyBatis-Plus 依赖
- 版本不兼容（特别是 Boot 3
+ 项目）[^3]
---
#### 二、解决方案步骤
##### 1. 检查 XML 文件位置与配置
```yaml
# application.yml 正确配置
mybatis
:
mapper-locations
:
- classpath
:mapper/**/*.xml # 多级目录匹配
- classpath*
:com/web/hospital/mapper/*.xml # 精确匹配
```
确保 XML 文件路径：
```
src/main/resources
├── mapper
│ └── UserMapper.xml # 推荐方式
└── com/web/hospital/mapper
└── UserMapper.xml # 需精确配置路径
```
##### 2. 验证 XML 映射内容
```xml
<!-- UserMapper.xml -->
<mapper namespace="com.web.hospital.mapper.UserMapper">
<!-- id 必须与方法名完全一致 -->
<select id="findAllStage" resultType="com.web.hospital.entity.User">
SELECT * FROM users
</select>
</mapper>
```
##### 3. 添加 Mapper 扫描注解
```
java
// 方案1：在接口上添加注解
@Mapper // 👈 关键注解
public interface UserMapper {
List<User> findAllStage
();
}
// 方案2：启动类全局扫描
@SpringBootApplication
@MapperScan
("com.web.hospital.mapper"
) // 👈 扫描整个包
public class Application {}
```
##### 4. 解决依赖冲突
```xml
<!-- pom.xml 正确配置 -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.5.4</version>
<exclusions>
<!-- 排除原生 MyBatis 避免冲突 -->
<exclusion>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
</exclusion>
</exclusions>
</dependency>
```
##### 5. 强制编译 XML 文件（
IDEA 特解）
```xml
<!-- pom.xml 添加资源过滤 -->
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.xml</include> <!-- 包含所有XML -->
</includes>
</resource>
</resources>
</build>
```
执行 `mvn clean install` 后检查 `target/classes` 是否包含 XML 文件[^4]
---
#### 三、排查流程图
```mermaid
graph TD
A[报错
Invalid bound statement] --> B{检查XML是否存在}
B -->|存在| C[验证namespace和方法ID]
B -->|不存在| D[检查mapper-locations配置]
C --> E[查看target目录是否有XML]
E -->|无| F[配置pom资源过滤]
E -->|有| G[检查@MapperScan路径]
G --> H[排除依赖冲突]
```
---
#### 四、常见问题补充
1. **方法重载导致混淆**
MyBatis 不支持方法重载，确保方法名唯一
2. **Boot 3
+ 特殊配置**
使用 `mybatis-plus-spring-boot3-starter` 替代原 starter[^3]
3. **多模块项目路径问题**
使用 `classpath*
:` 前缀跨模块扫描：
```yaml
mybatis
:
mapper-locations
: classpath*
:mapper/*.xml
```
---
#### 五、最佳实践
1. **保持接口名与XML文件名一致**（如 `UserMapper.
java` 和 `UserMapper.xml`）
2. **优先使用 `@MapperScan` 批量扫描**
3. **调试时检查 SqlSessionFactoryBean**：
```
java
@Autowired
void printMapped
Statements
(SqlSessionFactory factory
) {
factory.getConfiguration
().getMapped
Statements
()
.forEach
(System.out
::println
); // 打印所有已加载SQL
}
```
> 通过以上步骤，99% 的 `
Invalid bound statement` 错误可被解决。若仍存在问题，建议检查方法签名是否包含特殊参数类型（如 `@Param` 注解缺失）。
---
### 相关问题
1. MyBatis 中 `@Param` 注解的正确使用场景是什么？
2. 如何实现 MyBatis 多数据源配置？
3. MyBatis-Plus 的 `BaseMapper` 为何不需要 XML 映射？
4. MyBatis 结果集映射有哪些高级技巧？
本文介绍了在IDEA使用Maven构建的JavaWeb项目中遇到'invalid bound statement (not found)'错误的解决方案。包括检查XML文件命名空间、Mapper.java与Mapper.xml对应方法的匹配、ResultMap配置、XML配置路径的正确性，以及在pom.xml中添加资源扫描配置。如果以上步骤仍无法解决问题，建议尝试清理并重新构建项目。
扫一扫
3020
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
