本文详解 GORM 中 BelongsTo 关联的正确建模方式，重点解决因外键字段声明不当导致的预加载失败（如 Preload 报错 unsupported type struct）及关联查询失效问题。
本文详解 gorm 中 `belongsto` 关联的正确建模方式，重点解决因外键字段声明不当导致的预加载失败（如 `preload` 报错 unsupported type struct）及关联查询失效问题。
在 GORM 中，BelongsTo 关联（即“属于”关系）要求主表（如 Trade）必须显式包含外键字段，且该字段需为基本类型（如 int, uint），而非嵌套结构体。你原始代码中将 BuyExecution Execution 直接定义为结构体字段，并试图通过 gorm:"ForeignKey:BuyExecution" 指向一个不存在的 BuyExecution 字段，这违反了 GORM 的关联约定——GORM 无法从结构体字段推导出外键值，因此在 Preload 或 JOIN 查询时会报错：unsupported type models.Execution, a struct。
✅ 正确做法是：同时定义外键字段（如 BuyExecutionID int）和关联结构体字段（如 BuyExecution Execution），并通过 gorm:"foreignKey:BuyExecutionID" 显式绑定。注意：标签中的 foreignKey 参数必须指向你定义的 外键字段名（而非关联字段名），且该字段必须存在于当前结构体中。
以下是推荐的修正方案：
type Trade struct {
ID uint `gorm:"primaryKey"`
BuyExecutionID uint `gorm:"index"` // 外键字段，对应 executions.id
BuyExecution Execution `gorm:"foreignKey:BuyExecutionID"` // 关联字段
SellExecutionID uint `gorm:"index"`
SellExecution Execution `gorm:"foreignKey:SellExecutionID"`
Px int
Shares int
}
type Execution struct {
ID uint `gorm:"primaryKey"`
Side string
Symbol string
TradeID uint `gorm:"index"` // 对应 trade.id，用于反向 belongs-to
Trade *Trade `gorm:"foreignKey:TradeID"` // 可选：若需反向查询
}
⚠️ 关键注意事项：
- foreignKey 标签值（如 BuyExecutionID）必须是 Trade 结构体中真实存在的字段名，且类型需与被引用表主键一致（此处 executions.id 是 uint，故用 uint 而非 int）；
- 不要使用 gorm:"ForeignKey:BuyExecution"（错误：BuyExecution 是结构体字段，非外键）；
- 数据库表结构需同步匹配：trades.buy_execution_id 应为 INT UNSIGNED 或 BIGINT UNSIGNED，并与 executions.id 类型一致；
- 若使用 GORM v2（推荐），Preload 语法保持不变：db.Preload("BuyExecution").First(&trade)，此时 GORM 将自动通过 BuyExecutionID 关联查询 Execution；
- 建议为外键字段添加 index 标签以提升 JOIN 性能。
最后，执行迁移前请确认数据库字段已对齐：trades.buy_execution_id 和 trades.sell_execution_id 必须存在且类型兼容。GORM 不会自动创建外键字段——它只负责映射，结构一致性需开发者保障。
