混合云分页必须用带云感知的复合游标分页，禁用Offset；需显式传region、用(region, created_at, id)复合游标与索引、读写通道分离、Count走主库。
混合云数据库架构下，GORM 分页不能照搬单库逻辑——跨云数据同步延迟、主从读写分离、分片键与排序字段不一致，会让 Offset 分页直接失效，游标分页也容易因时钟漂移或 ID 冲突返回错乱结果。
Offset 分页在混合云里为什么一用就错
混合云常见部署是：核心业务写入私有云 MySQL 主库，公有云只读副本用于查询；或按地域分片（如 us-east、ap-southeast）后通过中间件聚合。此时 Offset 分页会暴露三个硬伤：
-
db.Offset(1000).Limit(20)在公有云只读实例上执行时，若主从延迟 200ms，可能漏掉刚写入但未同步的记录，翻页时“某条数据突然消失” - 分片架构下，不同分片的
id可能重复（比如各分片自增起始值不同），ORDER BY id ASC在聚合层失去全局单调性，导致游标WHERE id > 1005跨分片取数错位 - 公有云只读实例常关闭
binlog或启用read_only=1，但 GORM 的Count()若走同一 DB 实例，可能因 MVCC 快照版本不一致，总数和列表数据对不上
游标分页必须带“云感知”字段
纯 id 或 created_at 不再可靠，需叠加云环境标识字段才能保证游标唯一性：
- 如果分片键是
region，游标条件必须为WHERE region = ? AND (created_at, id) > (?, ?)，且复合索引要建在(region, created_at, id) - 若用时间戳，禁止直接用
time.Now().UnixMilli()—— 混合云节点时钟偏差可达 50ms，改用 NTP 校准后的bigint字段，或由中心服务统一分配单调递增的logic_id - 首次请求不能只查
ORDER BY created_at DESC, id DESC，得加WHERE region IN (?, ?, ?)显式限定可查分片，避免跨全部云区扫描
GORM Count 查询必须隔离读写通道
混合云下，总数统计不能和列表查询共用一个 *gorm.DB 实例，尤其当读写分离开启时：
- 列表查询走只读副本：
db.Session(&gorm.Session{Replica: true}) - 总数查询必须走主库或强一致性只读实例：
db.Session(&gorm.Session{Replica: false}).Model(&User{}).Where(...).Count(&total) - 若用子查询（如关联
JOIN profiles），db.Raw("SELECT COUNT(*) FROM (...) AS t")的 SQL 必须显式指定Session{Replica: false}，否则可能在延迟副本上执行，结果虚高
真正能落地的混合云分页结构
别封装成通用 Paginate() 函数——混合云的分页逻辑必须和业务拓扑强绑定。例如：
type CloudPage struct {
Region string `form:"region"` // 前端必须传当前用户归属 region
Cursor string `form:"cursor"` // base64 编码的 "1678901234567|1005"（timestamp|id）
Limit int `form:"limit"`
}
func ListUsers(db *gorm.DB, p CloudPage) ([]User, bool, error) {
// 解析 cursor，校验 timestamp 合法性（防重放、防超前）
ts, id, err := parseCursor(p.Cursor)
if err != nil {
return nil, false, fmt.Errorf("invalid cursor: %w", err)
}
var users []User
tx := db.Session(&gorm.Session{Replica: true})
// 强制 region + 时间+ID 复合游标，避免跨分片歧义
err = tx.Where("region = ? AND (created_at, id) > (?, ?)",
p.Region, ts, id).
Order("region, created_at DESC, id DESC").
Limit(p.Limit + 1). // 多查 1 条判断 has_next
Find(&users).Error
hasNext := len(users) > p.Limit
if hasNext {
users = users[:p.Limit]
}
return users, hasNext, err
}
关键点在于：游标解析、region 显式透传、复合排序与索引对齐、读写通道分离——少一个环节，混合云分页就会在某个流量高峰突然崩掉。
