调试 `
PageHelper`
分页不生效的问题，关键是确认 `
PageHelper.startPage()` 是否被正确拦截并作用于目标 SQL 查询。以下是详细的调试方法和步骤。
---
### ✅ 1. 确认
PageHelper 被正确引入
确保你的项目中引入了
PageHelper 的依赖，例如在 `pom.xml` 中：
```xml
<dependency>
<groupId>com.github.
pagehelper</groupId>
<artifactId>
pagehelper-
spring-
boot-starter</artifactId>
<version>1.4.
2</version>
</dependency>
```
---
### ✅
2. 确保 `
PageHelper.startPage()` 是紧跟的第一个查询
```
java
PageHelper.startPage(pageNum, pageSize);
List<Entity> list = yourMapper.selectAll(); // 必须紧跟
```
> ⚠️ 如果中间有其他 SQL 查询、日志打印、业务逻辑等操作，
PageHelper 可能失效。
---
### ✅ 3. 打印 SQL 日志（推荐使用 MyBatis-Plus 或 Logback）
#### 使用 `application.yml` 配置日志输出
```yaml
logging:
level:
com.your.package.mapper: debug
```
这样你就能在控制台看到实际执行的 SQL，确认是否带有 `LIMIT`。
#### 示例输出：
```sql
==> Preparing: SELECT * FROM ads_ent_base_info_nanshan WHERE dom_code LIKE ?
==> Parameters: %1
23456%(String)
<== Columns: id, dom_code, name, ...
<== Row: 1, 1
23456, "Company A", ...
<== Total: 10
```
如果看到 `LIMIT` 或 `ROWNUM`，说明
分页生效；否则说明未生效。
---
### ✅ 4. 使用 `PageInfo` 获取
分页信息进行验证
```
java
List<AdsEntBaseInfoNanshan> list = commercialEntity
Service.selectLikeDomCode(buildingCode);
PageInfo<AdsEntBaseInfoNanshan> pageInfo = new PageInfo<>(list);
System.out.println("当前页码: " + pageInfo.getPageNum());
System.out.println("每页数量: " + pageInfo.getPageSize());
System.out.println("总记录数: " + pageInfo.getTotal());
System.out.println("总页数: " + pageInfo.getPages());
```
---
### ✅ 5. 使用断点调试
在如下位置打断点：
```
java
PageHelper.startPage(pageNum, pageSize);
List<AdsEntBaseInfoNanshan> list = commercialEntity
Service.selectLikeDomCode(buildingCode);
```
查看 `list` 的大小是否是预期的
分页大小（如 pageSize=10，返回的 list 是否是 10 条数据）。
---
### ✅ 6. 检查 SQL 是否是动态 SQL 或嵌套查询
如果 SQL 是动态拼接的，或者有子查询、union 等复杂结构，
PageHelper 可能无法正确识别。
建议：
- 简化 SQL，测试是否
分页生效。
- 使用 `
PageHelper.offsetPage()` 替代 `
PageHelper.startPage()`。
- 使用 `
PageHelper.clearPage()` 清除上下文。
---
### ✅ 7. 检查是否使用了 `Page` 类型作为返回值
PageHelper 有时会自动封装为 `Page` 类型对象，比如：
```
java
Page<AdsEntBaseInfoNanshan> page = commercialEntity
Service.selectLikeDomCode(buildingCode);
```
你可以直接从 `page.getTotal()` 和 `page.size()` 获取信息。
---
### ✅ 8. 使用 `
PageHelper` 工具类验证
分页状态
```
java
Page<AdsEntBaseInfoNanshan> page =
PageHelper.getLocalPage();
if (page != null) {
System.out.println("当前页: " + page.getPageNum());
System.out.println("每页数量: " + page.getPageSize());
}
```
---
### ✅ 9. 使用 `PageInterceptor` 手动添加日志拦截器
你可以自定义一个拦截器，打印每次
分页的上下文：
```
java
@Intercepts({@Signature(type = StatementHandler.class, method = "prepare", args = {Connection.class, Integer.class})})
public class PageInterceptor implements Interceptor {
@Override
public Object intercept(Invocation invocation) throws Throwable {
// 打印
分页信息或 SQL
return invocation.proceed();
}
@Override
public Object plugin(Object target) {
return Plugin.wrap(target, this);
}
@Override
public void setProperties(Properties properties) {}
}
```
---
### ✅ 10. 检查是否是多数据源问题
如果你使用了多数据源（如 Dynamic-Datasource），
PageHelper 可能只对默认数据源生效。
解决办法：
- 在配置中启用
PageHelper 的多数据源支持。
- 或者使用 `
PageHelper.startPage().doSelectPageInfo(() -> mapper.select(...))` 函数式调用。
---
博客介绍了在Java项目中，通过在pom.xml添加架包，还给出了Service层代码。涉及Java、Spring及Spring Boot相关技术。
扫一扫
529
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
