GORM分页时Preload易失效，因分页限制仅作用于主表，导致子节点匹配不上结果集；正确做法是先查父级ID列表再单独查子节点，或改用Joins+Select。
直接用 GORM 做课程目录和课时的分页，不是不能做，而是容易在三个地方翻车：字段别名冲突、预加载失效、Count 与 Find 查询不一致。核心问题不在分页本身，而在你是否把「课程目录树」和「课时列表」当成两个独立查询来处理。
为什么 Preload 在分页时经常查不出子节点
课程目录通常是树形结构（比如一级分类 → 二级分类 → 课程），你可能会写：
db.Preload("Children").Where("parent_id = ?", 0).Find(&categories)
但一旦加了 Paginate 或 Limit/Offset，Preload 就会失效——因为 GORM 的 Preload 是在主查询之后单独发 SQL 加载关联数据，而分页限制只作用于主表，导致子节点匹配不上主结果集。
- 正确做法是：先查出当前页的父级 ID 列表（如
[]uint），再用Where("parent_id IN ?", parentIDs)单独查子节点，前端合并 - 不要依赖
Preload+Limit一起用，GORM v1.25+ 仍不保证语义一致性 - 如果必须用嵌套查询，改用
Joins+Select手动拼字段，避免Preload的 N+1 和错位风险
Scopes 和 Count 不同步导致分页总数错误
在线教育平台常要按状态（status = 'published'）、关键词（name LIKE ?）、分类（category_id = ?）组合筛选课时，你可能封装成一个 Scope：
func ByCourseID(courseID uint) func(db *gorm.DB) *gorm.DB {
return func(db *gorm.DB) *gorm.DB {
return db.Where("course_id = ?", courseID)
}
}
但调用时若这样写：
var lessons []Lesson db.Scopes(ByCourseID(123)).Limit(10).Offset(0).Find(&lessons) total := db.Scopes(ByCourseID(123)).Count(&lessons).Error // ❌ 错误！
Count 不会复用 Limit/Offset，但更隐蔽的问题是：如果你在 Scope 里用了 Joins 或 Group，Count 默认走的是 COUNT(*)，而实际需要的是 COUNT(DISTINCT lesson.id)。
- 必须显式用
db.Scopes(...).Model(&Lesson{}).Count(&total)，且确保Model指向正确结构体 - 涉及
Joins的分页，Count要手动写子查询：db.Table("(SELECT COUNT(DISTINCT id) FROM lessons WHERE ... ) AS count").Scan(&total) - 别信
db.Count(&total)的返回值——它只返回 error，total变量得自己传指针进去接
课时排序字段含中文或特殊字符时 Order 失效
课时列表常需按「第1讲」「第2讲」或「导学视频」「实战演练」排序，但数据库里存的是字符串。如果直接：
db.Order("sort_order ASC").Find(&lessons)
在 MySQL 中，sort_order 是 VARCHAR 类型，"10" 会排在 "2" 前面；若字段含 emoji 或 UTF-8mb4 字符，还可能触发 COLLATION 冲突，报错 Illegal mix of collations。
- 解决方案一：加计算字段，如
ALTER TABLE lessons ADD COLUMN sort_index INT AS (CAST(REGEXP_SUBSTR(name, '[0-9]+') AS UNSIGNED)) STORED，然后Order("sort_index") - 解决方案二：用
db.Session(&gorm.Session{DryRun: true}).Order("name").Find(&lessons)看生成 SQL，确认排序是否被驱动转义 - MySQL 8.0+ 可用
ORDER BY CAST(SUBSTRING_INDEX(name, '第', -1) AS UNSIGNED)，但 GORM 不支持原生表达式直接进Order，得走Unscoped().Select("*, CAST(...) AS sort_calc").Order("sort_calc")
最易被忽略的一点：课程目录的「展开/收起」状态不该由后端分页接口承担。GORM 分页只负责把当前层级的数据切片返回，前端控制树节点开关；一旦你试图让后端返回「已展开的全部子孙节点」，就等于放弃了分页意义，也极易触发超时或内存溢出——尤其是当某门课有 200+ 课时、目录嵌套 5 层时。
