当 GORM 模型使用自定义主键字段（如 sys_id 而非默认 id）时，若仅通过 ForeignKey 声明关联关系，预加载会因无法自动推导外键匹配而失败；需显式指定 AssociationForeignKey 才能正确关联并加载子数据。
当 gorm 模型使用自定义主键字段（如 `sys_id` 而非默认 `id`）时，若仅通过 `foreignkey` 声明关联关系，预加载会因无法自动推导外键匹配而失败；需显式指定 `associationforeignkey` 才能正确关联并加载子数据。
在使用 GORM 进行一对多关联查询（如职位 Positions 关联多个附件 Attachment）时，若模型未遵循 GORM 默认命名约定（例如主键字段名为 sys_id 而非 id），则 Preload 会静默失败——看似无报错，但关联切片为空，并可能抛出类似 can't preload field Attachments for models.Positions 的错误。
根本原因在于：GORM 在解析 has_many 关联时，默认假设关联表（Attachment）的外键（RecordId）指向主表（Positions）的 id 字段。而你的 Positions 结构体中主键是 Sys_id，且未显式声明该字段为关联的“被引用列”，导致 GORM 无法建立正确的 JOIN 或子查询逻辑。
✅ 正确做法是：同时指定 ForeignKey 和 AssociationForeignKey，明确告知 GORM “谁引用谁”：
type Positions struct {
Sys_id int `gorm:"primaryKey;column:sys_id"`
Name string `gorm:"size:120;column:name"`
OpenPositions int `gorm:"column:open_positions"`
ContactList string `gorm:"size:1000;column:contact_list"`
Attachments []Attachment `gorm:"foreignKey:RecordId;associationForeignKey:Sys_id"`
}
type Attachment struct {
Sys_id int `gorm:"primaryKey;column:sys_id"`
Name string `gorm:"size:255;column:name"`
File string `gorm:"size:255;column:file"`
RecordId int `gorm:"column:record_id"`
Table string `gorm:"size:255;column:table"`
}⚠️ 注意事项：
-
associationForeignKey的值必须与主模型中实际主键字段名完全一致（区分大小写），此处为Sys_id（结构体字段名），而非数据库列名sys_id； - 若主键字段已用
gorm:"primaryKey"标记，仍需在 tag 中显式写出字段名，GORM 不会自动映射结构体字段名到关联逻辑； - 预加载条件（如过滤
table = 'user_position'）应置于Preload第二参数中，写法正确：db.Where("open_positions > ?", 0). Preload("Attachments", "table = ?", "user_position"). Find(&positions2) - 建议为所有主键和外键字段添加
gorm:"primaryKey"/gorm:"index"等标签，提升可读性与性能。
? 总结：GORM 的预加载依赖于精确的外键语义对齐。脱离默认约定（id 主键 + xxx_id 外键）时，必须通过 associationForeignKey 显式补全关联元信息——这是避免“预加载无声失效”的关键实践。
