Preload字段名须与结构体字段名严格一致且首字母大写；BelongsTo需显式定义匹配类型的外键字段；HasMany需手动调用Association.Append()写入；Joins需Select指定字段，Preload不支持跨表条件过滤。
Preload字段名拼错或大小写不匹配
Preload参数必须是结构体字段名，不是数据库列名，且严格区分大小写。比如结构体里定义的是 Posts 字段，写成 preload("posts") 或 preload("Post") 都会失效，关联数据为空切片。
常见错误现象：日志显示 SQL 有 JOIN，但 Go 结构体中关联字段仍是零值；db.Debug().Preload("User").Find(&orders) 查出 orders，但每个 order.User.Name 是空字符串。
- 检查 struct tag 中的
foreignKey和字段名是否一致，例如User *User `gorm:"foreignKey:UserID"`要求结构体中必须存在名为UserID的字段 - 确保被预加载的字段已导出（首字母大写），否则 GORM 反射无法赋值
- 用
db.Debug().Preload("User").First(&order)看生成的 SQL 是否真包含SELECT ... FROM users—— 若没有，说明 Preload 根本没生效
BelongsTo 关联外键字段缺失或类型不一致
BelongsTo 不会自动从关联结构体推导外键，必须显式声明一个整型 ID 字段，并通过 foreignKey 指向它。否则会出现 unsupported type struct 或空值。
常见错误现象：db.Preload("BuyExecution").First(&trade) 报错 sql: converting argument #0's type: unsupported type models.Execution，本质是 GORM 找不到 BuyExecutionID 字段，转而试图把整个结构体当参数传给 SQL。
立即学习“go语言免费学习笔记（深入）”；
- 主模型（如
Trade）中必须定义独立外键字段，如BuyExecutionID uint，类型须与被引用模型（Execution.ID）完全一致 -
BuyExecution Execution `gorm:"foreignKey:BuyExecutionID"`中的BuyExecutionID是字段名，不是数据库列名；若列名是buy_execution_id，需额外加column:buy_execution_id - 用
db.Model(&trade).Association("BuyExecution").Find(&exec)单独测试该关联是否通，比跑完整查询更快定位问题
HasMany 写入后查询不到关联数据
Create 默认只插入主表，即使 HasMany 字段已正确定义并赋值，也不会自动入库。这不是 bug，是 GORM 明确的设计行为。
常见错误现象：新建 Podcast 并附带 Episodes 切片，调用 db.Create(&podcast) 后查 podcast.Episodes 为空；或用 db.Preload("Episodes").First(&podcast) 返回空切片。
- 必须显式调用关联方法写入：
db.Create(&podcast).Association("Episodes").Append(episodes)，其中"Episodes"是结构体字段名 - 子表外键字段（如
PodcastID）类型必须与父表主键（Podcast.ID）严格一致；写成int、*uint或漏掉字段都会静默失败 - 若先查再关联，确保父记录已持久化（
ID != 0），否则外键为零导致invalid association []
Joins 与 Preload 混用导致字段丢失或重复
Joins 拼的是原生 SQL，不自动映射到结构体字段；Preload 发多条 SQL，但支持嵌套。选错方式会导致数据拿不到、count 失真或 N+1 查询。
常见错误现象：用 db.Joins("User").Find(&orders) 后，orders[0].User.Name 仍是空；或分页查用户 + 订单数时，COUNT(*) 返回总数而非每用户订单数。
- Joins 后必须手动
Select("*")或明确列出字段，否则 GORM 默认只 SELECT 主表字段，关联字段被丢弃 - 需要跨表 WHERE（如只查
status = 'active'的订单对应用户），只能用Joins+Where，Preload(..., db.Where())的 Where 只作用于子查询，不参与主 JOIN 条件 - 要精确获取「每个用户的订单数」，别用
Preload("Orders")后在 Go 层 len()，改用Select("users.*, COUNT(orders.id) as order_count").Joins("left join orders...").Group("users.id")
