Gin 不参与查询逻辑，多表联合查询依赖 GORM 的 Preload、Joins 和原生 SQL；用错会导致 N+1、字段丢失、NULL 误判或事务失效。
直接说结论：Gin 本身不参与查询逻辑，真正的多表联合复杂查询全靠 GORM 的 Preload、Joins 和原生 SQL 三类手段配合完成；用错方式会导致 N+1、字段丢失、NULL 值误判或事务失效。
什么时候必须用 Joins 而不是 Preload
当你需要在 WHERE、ORDER BY 或 SELECT 中直接引用关联表字段时，Preload 就不够用了——它只做“额外查一次再拼装”，不真正 JOIN 到主查询里。
-
Preload("Lesson")会发两条 SQL：先查学生，再查所有匹配的课程，然后在内存里组装。课程字段不能用于主查询的排序或过滤 -
Joins("LEFT JOIN lesson_student ON student.id = lesson_student.student_id")才是真 JOIN，能用lesson_student.lesson_id > 5这种条件，也能SELECT student.name, lesson.name - 常见错误：写
Preload("Lesson").Where("lesson.name LIKE ?", "%网络%")——这会报错，因为lesson表根本没出现在主查询 FROM 子句中 - 正确写法示例：
var result []struct { StudentName string `gorm:"column:student.name"` LessonName string `gorm:"column:lesson.name"` } models.DB.Table("student"). Select("student.name, lesson.name"). Joins("JOIN lesson_student ON student.id = lesson_student.student_id"). Joins("JOIN lesson ON lesson_student.lesson_id = lesson.id"). Where("lesson.name LIKE ?", "%网络%"). Find(&result)
Preload 的嵌套与条件过滤容易踩的坑
Preload 看似简单，但嵌套多层或加条件时极易漏掉参数绑定或作用域错位。
- 单层带条件没问题：
Preload("Lesson", func(db *gorm.DB) *gorm.DB { return db.Where("status = ?", 1) }) - 嵌套两层就容易出错：比如
Student → Lesson → Teacher，想只加载状态为 1 的课程及其对应老师，必须逐层写闭包，不能只写最外层 - 错误写法：
Preload("Lesson.Teacher").Where("lesson.status = 1")——lesson.status在主查询中不可见，WHERE 无效 - 正确写法（需两层闭包）：
models.DB.Preload("Lesson", func(db *gorm.DB) *gorm.DB { return db.Where("status = ?", 1).Preload("Teacher") }).Find(&students) - 另一个坑：
Preload的第二个参数是条件 SQL 片段，不是完整语句，不能写SELECT或ORDER BY，否则 panic
原生 SQL 是最后的兜底方案，但要注意上下文和扫描目标
当 Joins 写法太绕、或需要窗口函数、UNION、子查询等高级能力时，Raw 是唯一选择，但它绕过了 GORM 的结构体映射逻辑，必须手动对齐字段。
- 别直接
Scan(&[]models.Student{})——原生 SQL 返回的列名和结构体 tag 不一定匹配，容易扫成零值 - 推荐用匿名 struct 显式声明字段：
var res []struct { ID uint `gorm:"column:id"` Name string `gorm:"column:name"` CourseNum int `gorm:"column:course_num"` } models.DB.Raw(` SELECT s.id, s.name, COUNT(ls.lesson_id) AS course_num FROM student s LEFT JOIN lesson_student ls ON s.id = ls.student_id GROUP BY s.id, s.name HAVING course_num > 2 `).Scan(&res) - 注意事务：如果在 Gin handler 里开了事务（
tx := models.DB.Begin()），原生 SQL 必须用tx.Raw(...)，否则脱离事务上下文 - 参数占位符统一用
?，不要混用$1或:name，MySQL 驱动只认?
复杂点在于：Joins 和 Preload 不能混用在同一查询链上（GORM 会忽略后者），而原生 SQL 又失去 GORM 的链式构建能力。实际项目里，建议把高频复杂联查封装成 Repository 方法，内部统一用 Raw + struct 扫描，避免每次都在 handler 里拼 SQL 字符串。
