GORM的Offset分页在千万级数据上会卡死，因为MySQL执行OFFSET需真实扫描并丢弃前N行，而非跳过，导致IO和CPU飙升、结果不一致；应改用带索引保障的游标分页。
为什么GORM的Offset分页在千万级单表上会卡死
因为MySQL执行OFFSET 500000时，不是“跳过”50万行，而是真实扫描、比较、丢弃前50万行——每行都要走主键索引+回表（如果SELECT *），CPU和IO双飙升。GORM里写db.Offset(499999).Limit(20)，第5000页可能耗时3秒以上，连接池迅速被占满，且结果顺序不可重现。
常见错误现象：Count()返回总数100万，但Offset(999999).Limit(1)查不到最后一条；同一页刷新两次，created_at相同的数据顺序不一致，甚至漏记录。
- 必须显式加
Order("id ASC")或Order("created_at DESC, id DESC")，否则无序结果无法分页复现 -
Offset值不能由前端直接传入，要校验page >= 1且pageSize在1–100之间 - 别在
Count()查询里复用带Limit/Offset的DB实例——它会忽略这些条件，导致总数不准
GORM游标分页怎么写才不丢数据
游标分页本质是“基于上一页最后一条记录的排序字段值继续往后取”，绕开OFFSET物理扫描。但错一个细节就翻车：比如用created_at当游标却没加id兜底，高并发下时间戳重复会导致跳行或重复。
正确写法：
- 首次请求：
db.Order("id ASC").Limit(20).Find(&users)，不带Where - 后续请求：
db.Where("id > ?", lastID).Order("id ASC").Limit(20).Find(&users)，lastID必须来自上一页最后一条的id字段值 -
last_id必须由前端透传，后端不做页码转换；若非法（如负数、非数字），应返回HTTP 400，不能静默 fallback 到第1页 - 如果排序用
created_at DESC，条件得改成db.Where("created_at ，且数据库字段建议用DATETIME(3)或BIGINT时间戳避免精度丢失
关联查询场景下Count总数怎么算才准又快
单表游标分页解决了读性能，但带Joins或Preload的关联分页，Count()极易出错：它不会继承JOIN条件，纯按模型表硬扫，总数虚高。
典型陷阱：你写了db.Joins("JOIN profiles ON users.id = profiles.user_id").Where("profiles.active", true)查用户，却用db.Model(&User{}).Where("profiles.active", true).Count(&total)——这个Where根本找不到profiles表，条件被忽略，总数比实际多几倍。
- 简单场景：用
db.Session(&gorm.Session{NewDB: true}).Model(&User{}).Where(...).Count(&total)隔离会话，避免污染 - 复杂关联：手写子查询，例如
db.Raw("SELECT COUNT(*) FROM (SELECT 1 FROM users u JOIN profiles p ON u.id = p.user_id WHERE p.active = ?) AS t", true).Scan(&total) - 覆盖索引优化：避免
SELECT *，只查分页必需字段，减少回表；游标字段（如id）必须有索引，且最好是主键
FindInBatches真能替代分页吗？什么情况下不能用
FindInBatches不是分页接口，而是“分批扫描”，适合后台导出、ETL、定时任务等无需前端交互的场景。它底层是游标式WHERE + ORDER BY，但不返回has_more标志，也不要求客户端维护last_id。
它能解决深分页雪崩，但不能直接用于API分页响应：
- 它没有内置“是否还有下一批”的判断逻辑，需手动检查
len(results) - 它不支持
ORDER BY created_at DESC这类非单调字段的稳定游标——因为created_at可能重复，FindInBatches默认按id补排序，但业务排序意图会被覆盖 - 它不适用于需要随机跳转页码的场景（比如用户点“第100页”），只能顺序向后扫
- 如果你的API已用游标分页（如Dify风格
?limit=20&last_id=xxx），就别混用FindInBatches，二者语义不同，容易让前端误解分页状态
真正容易被忽略的是：游标值必须来自数据库原生字段，不能是计算列、JSON解析值或前端拼接字符串——哪怕只差一个空格，WHERE条件就失效，整批数据消失。
