[特殊字符] 【踩坑记录】没调 startPage(),SQL 却被自动分页了?

🚀 【踩坑记录】没调 startPage(),SQL 却被自动分页了?

1. 现象

Controller 中没写 PageHelper.startPage(),但执行 SQL 时末尾自动出现了 LIMIT,导致查询结果数量不对。

2. 核心原因:ThreadLocal 污染

PageHelper 的分页参数存放在 ThreadLocal 中。

  • 脏数据来源 :如果前一个请求调用了 startPage() 但没有执行查询 (由于异常或 if 逻辑提前返回),分页参数会残留在线程中。
  • 线程池复用:Tomcat 线程池会复用线程。下一个请求(即你的接口)碰巧使用了这个"脏线程",PageHelper 拦截器就会自动读取残余参数并触发分页。
3. 诱因:参数自动匹配 (supportMethodsArguments)

检查配置文件:pagehelper.supportMethodsArguments: true。

如果开启此项,PageHelper 会自动反射扫描你的请求对象。只要你的公共类里有 pageNum 和 pageSize 字段且不为空,它就会自动开启分页,无需手动调用。

4. 解决方案
  • 规范化 :确保 startPage() 后紧跟查询,或在 finally 块执行 PageHelper.clearPage()。

  • 改配置 :建议将 support-methods-arguments 设为 false,由代码显式控制分页,减少"黑盒"行为。

    yml 复制代码
    pagehelper:
      support-methods-arguments: false
  • 强力清空 :在不需要分页的接口开头手动调用 PageHelper.clearPage() 以防万一。

相关推荐
Decay__2 小时前
SQLServer 监控体系构建 —— sql_exporter + Prometheus + Grafana 全栈实战
运维·数据库·sql·mysql·架构
tianyuanwo3 小时前
NocoDB 系统手册:PostgreSQL 主机资产管理的界面层实施方案
数据库·postgresql·oracle
Umi·3 小时前
MySQL之多表关联查询练习
数据库·mysql
实泽有之,无泽虚之3 小时前
Windows环境bat脚本自动备份MySQL数据库并清理旧备份文件
数据库·mysql
索西引擎4 小时前
MySQL 进阶:锁机制
数据库·mysql
龙腾AI白云5 小时前
具身智能模仿学习与人类示教:从观察中习得动作
数据库·机器学习·知识图谱·pygame
Databend5 小时前
活动邀请函|AI 时代的湖仓实践,从应用场景到 Cloud Agent 上手
大数据·数据库·agent
星恒随风5 小时前
MySQL 从零入门(七):索引原理与 B+ 树详解——从磁盘 I/O 到 InnoDB 聚簇索引
linux·服务器·数据库·笔记·mysql
倔强的石头_5 小时前
数据库性能优化手记:一次从KWR到改代码的完整排查
数据库