###
Spring Boot 中 '
Invalid bound statement (not found)'
错误的解决方案
此
错误通常发生在
MyBatis 或
MyBatis-Plus 配置不当的情况下，具体表现为无法找到 Mapper 接口或其对应的 XML 文件。以下是对此问题的深入解析和解决方法。
#### 1. 检查 `@MapperScan` 注解是否正确配置
如果
项目中未正确扫描到 Mapper 接口所在的包，则可能导致该
错误。需确保在启动类或其他配置类上添加了 `@MapperScan` 注解，并指定正确的包路径[^1]：
```java
@
SpringBootApplication
@MapperScan
("com.example.mapper"
) // 替换为实际的Mapper接口所在包路径
public class Application {
public static void main
(String[] args
) {
SpringApplication.run
(Application.class, args
);
}
}
```
#### 2. 确认 `
mybatis.mapper-locations` 是否指向正确的 XML 路径
MyBatis 的映射文件（XML）需要被正确加载才能与 Mapper 接口绑定。可以通过设置 `
mybatis.mapper-locations` 属性来指定 XML 文件的位置[^3]。例如，在 `application.yml` 中配置如下：
```yaml
mybatis:
mapper-locations: classpath:mapper/*.xml # 替换为实际的XML文件位置
```
注意：路径中的通配符应匹配
项目的目录结构，否则可能遗漏某些 XML 文件。
#### 3. 核实 Mapper 接口名称与 XML 文件名的一致性
MyBatis 默认会根据 Mapper 接口全限定名寻找同名的 XML 文件。因此，确保 Mapper 接口的命名与其对应 XML 文件保持一致是非常重要的[^2]。例如，对于以下接口定义：
```java
package com.example.mapper;
import org.apache.ibatis.an
notations.Mapper;
import com.baomidou.
mybatisplus.core.mapper.BaseMapper;
@Mapper
public interface UserMapper extends BaseMapper<User> {}
```
其对应的 XML 文件应当命名为 `UserMapper.xml` 并放置于上述配置所指的路径下。
#### 4. 检查依赖版本兼容性
不同版本的
Spring Boot 和
MyBatis/
MyBatis-Plus 可能存在兼容性问题。建议查阅官方文档并调整至推荐组合版本。例如，当使用
Spring Boot 3.x 版本时，可搭配
MyBatis-Plus 3.5.x 使用。
#### 5. 排查 IDE 设置影响
部分开发工具（如 IntelliJ IDEA）可能存在大小写敏感度差异的情况，这可能会干扰资源定位逻辑[^4]。可通过清理缓存
(`File ->
Invalidate Caches / Restart`
) 来尝试解决问题；或者切换构建工具命令运行程序以排除环境因素干扰。
---
### 示例代码片段
以下是一个完整的 Maven
项目示例配置，展示如何集成
MyBatis-Plus 并规避常见配置陷阱：
```xml
<dependencies>
<!--
Spring Boot Starter -->
<dependency>
<groupId>org.
springframework.
boot</groupId>
<artifactId>
spring-
boot-starter-web</artifactId>
</dependency>
<!--
MyBatis Plus -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>
mybatis-plus-
boot-starter</artifactId>
<version>3.5.9</version>
</dependency>
<!-- MySQL Driver -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
</dependencies>
```
同时，确保数据库连接池等相关组件已正确定义。
---
####
解决SpringBootInvalidboundstatement(NotFound)错误
本文讲述了作者在处理SpringBoot项目中遇到的Invalidboundstatement(NotFound)错误，尝试了多次配置后，最终参考51CTO上的一篇文章解决了问题，链接为：https://blog.51cto.com/u_15300443/3048458。
扫一扫
2208
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
