### 解决
MyBatisPlus 分页查询时出现 '
Invalid Bound Statement' 错误的问题
#### 问题分析
当遇到 `
Invalid bound statement (not found)` 错误时，这表明
MyBatis 没有正确加载对应的 Mapper 方法。此问题可能由以下几个原因引起：Mapper 接口未被扫描到、XML 文件路径配置错误、
MyBatis 版本冲突或其他配置不当的情况。
---
#### 解决方案
##### 1. 确保 Mapper 接口被正确扫描
在 Spring Boot 中，可以通过以下两种方式之一来确保 Mapper 接口被正确识别：
- **
使用 `@MapperScan` 注解**
在应用程序的启动类或配置类中添加 `@MapperScan` 注解，并指定 Mapper 接口所在的包路径：
```
java
@SpringBootApplication
@MapperScan("com.example.mapper") // 替换为实际的 Mapper 包路径
public class Application {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
```
- **
使用 `@Mapper` 注解**
在每个 Mapper 接口中单独加上 `@Mapper` 注解：
```
java
@Mapper
public interface QuestionMapper extends BaseMapper<Question> {
}
```
这两种方式都可以解决问题，推荐优先
使用全局扫描的方式以减少重复工作[^1]。
---
##### 2. 检查 XML 映射文件的位置
如果项目中有自定义的 SQL 或者混合了 XML 方式的映射文件，则需要确认这些文件是否放置在正确的目录下。默认情况下，Spring Boot 会自动扫描 `resources/mapper/` 下的 XML 文件。如果 XML 文件位于其他位置，可以手动指定其路径：
```properties
mybatis.mapper
-locations=classpath:mappers/*.xml
```
此外，还需要确保 XML 文件中的命名空间与对应的 Mapper 接口完全一致。例如：
```xml
<mapper namespace="com.example.mapper.QuestionMapper">
<!
-- 自定义SQL语句
-->
</mapper>
```
如果不小心将命名空间设置成了其他值（比如拼写错误），也会导致无法绑定对应的方法[^2]。
---
##### 3. 验证依赖版本一致性
有时由于不同模块之间的版本差异可能导致异常行为。因此建议检查项目的 POM 文件，确保所
使用的
MyBatis 和
MyBatis-Plus 的版本相互兼容。例如：
```xml
<!
-- MyBatis Plus 核心库
-->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>
mybatis-plus-boot
-starter</artifactId>
<version>最新稳定版</version>
</dependency>
<!
-- 如果涉及分页插件
-->
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper
-spring
-boot
-starter</artifactId>
<version>最新稳定版</version>
</dependency>
```
同时注意避免混用旧版 API 导致混淆。例如，早期版本可能会导入如下内容：
```
java
// 这是一个过期的 import，请勿再
使用
import com.baomidou.
mybatisplus.mapper.BaseMapper;
```
而应该替换为最新的核心组件：
```
java
import com.baomidou.
mybatisplus.core.mapper.BaseMapper;
```
---
##### 4. 添加日志调试信息
为了进一步定位问题所在，可以在 application.properties 或 application.yml 文件中开启
MyBatis 日志打印功能：
```properties
logging.level.com.example.mapper=DEBUG
mybatis.configuration.log
-impl=org.apache.ibatis.logging.stdout.StdOutImpl
```
这样就可以观察到每次执行操作的具体过程以及是否有尝试去寻找某个不存在的 mapper 方法等细节[^3]。
---
##### 5. 测试代码验证
最后提供一段简单的测试代码供参考，帮助快速重现并排除潜在隐患：
```
java
@SpringBootTest
public class QuestionMapperTest {
@Autowired
private QuestionMapper questionMapper;
@Test
public void testSelectPage() {
Page<Question> page = new Page<>(1, 10); // 第一页，每页十条记录
IPage<Question> result = questionMapper.selectPage(page, null);
System.out.println("总条数：" + result.getTotal());
System.out.println("当前页：" + result.getCurrent());
System.out.println("数据列表：" + result.getRecords());
}
}
```
运行上述单元测试后如果没有抛出异常则说明基础环境搭建正常；反之可根据堆栈追踪更深入地查找根源[^4]。
---
### 总结
综上所述，“
Invalid bound statement”通常是因 Mapper 接口未能正确定位引起的。通过合理运用注解机制、校验资源配置项、保持技术栈统一等方式均能有效规避此类风险。
---
最低0.47元/天 解锁文章
扫一扫
2211
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
