gorm v1.22及更早版本不支持preload多级嵌套，需升级至v1.23.0+并确保外键定义正确；降级方案为分步查询或改用joins+select显式联表。
gorm.Preload 多级嵌套失效怎么办
Preload("Orders.Items") 在 GORM v1.22 及更早版本中根本不会生效，不是写法错，是版本不支持。日志里看不到额外 SQL，Orders 能查出来但 Items 始终为空 slice，这是典型症状。
- 先执行
go list -m gorm.io/gorm确认版本：低于v1.23.0必须升级或改写 - 升级后仍需确保
Items结构体里定义了正确的 foreign key，比如OrderID uint+gorm:"index" - 降级兼容方案：先
Preload("Orders")查出订单列表，再用db.Where("order_id IN ?", orderIDs).Find(&items)批量查子项 - 别在 Preload 里混用
Select()，例如Preload("Orders", db.Select("id,user_id"))会导致关联字段丢失（如created_at不加载）
用 Joins 替代 Preload 实现可控联表查询
Preload 生成的 LEFT JOIN 往往字段冗余、无法控制 SELECT 列表，且对复杂条件支持弱。真要多表关联，Joins 更直接、可预测。
-
Joins("JOIN orders ON orders.user_id = users.id").Joins("JOIN items ON items.order_id = orders.id")是显式左连接，顺序和 ON 条件自己掌握 - 必须搭配
Select()明确字段，否则 GORM 默认 SELECT *，容易拉回大量无用列 - WHERE 条件写在主表上没问题，但跨表过滤要用
Where("items.status = ?", "paid")，注意字段前缀 - 别指望
Joins自动填充结构体嵌套字段——它只拼 SQL，结果得靠自定义接收 struct（如type OrderItemResult struct { UserName string; OrderNo string; ItemName string }）
Update() 强制更新零值字段的坑
Update("age", 0) 或 Updates(map[string]interface{}{"age": 0}) 行为完全不同：前者被跳过，后者能写入。这不是 bug，是 GORM 对“零值”的默认过滤策略。
-
Update()默认跳过所有 Go 零值（0,"",nil），除非字段 tag 里写了gorm:"default:0"且你传的是非零值 - 安全写法是显式
Select("age").Update("age", 0)，强制指定字段 -
Updates(map[string]interface{})绕过零值判断，但 key 必须是数据库列名（如"user_age"），不是 struct 字段名（如"Age"） - 批量更新慎用
Model(&User{}).Where(...).Updates(...)，它会忽略 struct tag 中的gorm:"-"字段，但 map 写法不会
事务里嵌套 Begin() 导致 invalid transaction panic
在已开启的事务内调用 db.Begin() 或 db.Transaction()，GORM 会 panic 报 "invalid transaction"。这不是并发问题，而是事务上下文绑定失败。
- 函数签名必须接收
*gorm.DB参数，而不是重新db.Begin() - 外部事务已通过
tx := db.Begin()启动，内部逻辑应直接用tx操作，比如tx.Model(&u).Update(...) - 别在 defer 里写
tx.Rollback()然后又在中间tx.Commit()—— Rollback 和 Commit 是互斥的，二次调用会 panic - 事务函数返回 error 时才 rollback，成功就 commit；没显式 commit 的事务，退出作用域自动 rollback
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
