GORM分页不能用中间件拦截，因其无请求级自动分页钩子，Find等方法不读HTTP参数，也不自动拼LIMIT/OFFSET；须显式提取参数并传入查询链，推荐在handler内调用自封装Paginate函数。
为什么 GORM 的 Pagination 不能直接用中间件拦截？
GORM 本身不提供请求级的“自动分页”钩子，Find、First 等方法不会主动读取 HTTP 查询参数（如 page、limit），更不会自动拼 LIMIT/OFFSET。所谓“拦截器”，其实是把分页逻辑提前注入到查询构建阶段，而不是在 SQL 执行后做裁剪。
常见错误是试图在 Gin 中间件里对 *gorm.DB 做全局修改——这没用，因为每个 handler 拿到的 *gorm.DB 是新实例，且未携带上下文分页意图。
- 必须把分页参数从 HTTP 请求提取出来，显式传入查询链
- 推荐在 handler 内部调用封装好的分页函数，而非依赖中间件“自动附加”
- 若强行用中间件，只能靠 context.Value 透传参数，但易漏、难调试、破坏可测试性
如何用 Paginate 封装一个安全的分页函数？
最轻量也最可控的方式：写一个接受 *gorm.DB、分页参数和目标结构体的函数，返回带 Count 和分页数据的结构。别依赖第三方分页库，几行就能写清楚。
关键点在于：Count 查询要复用原始条件（避免 where 条件漏掉），且 Limit/Offset 必须在最终 Find 前才加，否则会影响 count 结果。
func Paginate(db *gorm.DB, page, limit int, out interface{}) error {
offset := (page - 1) * limit
if page < 1 {
page = 1
offset = 0
}
if limit < 1 {
limit = 10
}
<pre class='brush:php;toolbar:false;'>var total int64
db.Count(&total).Error // 复用 db 的所有条件（where/order/joins）
err := db.Limit(limit).Offset(offset).Find(out).Error
if err != nil {
return err
}
// 可选：把 total 注入 out（如果 out 是 struct，需支持 Total 字段）
return nil}
-
db.Count()必须在Limit/Offset之前调用，否则 count 不准 - 不要在
Paginate内部做db.Session()或db.Scopes()，让调用方控制查询上下文 - 若需返回 total，建议用独立字段（如
PageResult{Data: ..., Total: ...}），别强求塞进业务 struct
为什么 Scopes + func(db *gorm.DB) *gorm.DB 是更灵活的方案？
比起封装函数，GORM 的 Scopes 更适合组合式分页逻辑，尤其当你需要和其它查询逻辑（如 soft delete、tenant filter）混用时。
定义一个 scope 函数，接收分页参数并返回闭包：
func PaginateScope(page, limit int) func(db *gorm.DB) *gorm.DB {
return func(db *gorm.DB) *gorm.DB {
if page < 1 {
page = 1
}
if limit < 1 {
limit = 10
}
offset := (page - 1) * limit
return db.Limit(limit).Offset(offset)
}
}使用时链式调用：
var users []User
db.Scopes(
TenantScope("org-123"), // 租户过滤
PaginateScope(2, 20), // 分页
).Find(&users)- scope 顺序很重要：分页 scope 必须放在最后，否则
Limit/Offset会干扰前面的 count 或 join - scope 无法直接拿到 count，如需 total，仍得单独跑一次
Count查询（复用相同 scopes） - 比封装函数更适合多层抽象（比如 baseRepo 层统一加 tenant + status 过滤）
容易被忽略的性能与兼容性陷阱
分页不是加个 Limit 就完事。真实场景下，OFFSET 越大越慢，尤其是千万级表；另外 GORM v2 的 Count 行为在复杂查询中可能出错。
- 避免
OFFSET深翻：当page > 1000时，考虑游标分页（用created_at < ?替代OFFSET） -
Count在含GROUP BY或嵌套SELECT时可能报错或不准，此时应手动写Raw子查询 - MySQL 8.0+ 支持
ROW_NUMBER()，但 GORM 不自动优化，需手写Session(&gorm.Session{DryRun: true})查看生成 SQL - SQLite 不支持
OFFSET超过约 10⁹，上线前务必在目标数据库验证边界值
分页逻辑看着简单，真正稳定支撑高并发列表，靠的是对每条 SQL 的生成路径和执行计划有明确预期，而不是堆砌封装。
