Gorm Join操作列名重复导致Find解析错误的解决方案咨询

核心原因 #

Join查询返回的是两表字段拼接后的宽结果集，连续调用两次Find()不会自动拆分两表数据，Gorm扫描结构体时默认按列名匹配，结果集中两个同名id列会出现值覆盖，直接导致字段映射错位。

以下方案均不需要修改原有数据库模型结构体、不需要调整表字段名： #

方案1：临时组合结构体 + 显式字段别名（最稳妥，推荐） #

仅在当前查询逻辑内定义临时组合结构体，嵌入原有两个表的模型，查询时给重名字段加别名匹配即可，完全不侵入原有模型定义：

// 仅当前查询场景使用，不影响全局模型
type JoinRow struct {
    Struct1
    Struct2
}

var rows []JoinRow
// 注意不要用Select("*")，手动给冲突字段加别名
db.Model(&Struct1{}).
    Select("struct1.*, struct2.id as struct2_id, struct2.col1, struct2.col2"). // 除id外其他无冲突字段可正常查询
    Joins("JOIN table2 struct2 ON 你的关联条件").
    Where("你的过滤条件").
    Find(&rows)

// 拆分结果到两个数组
var array1 []Struct1
var array2 []Struct2
for _, row := range rows {
    array1 = append(array1, row.Struct1)
    // 手动给冲突的id字段赋值
    row.Struct2.ID = row.Struct2Id
    array2 = append(array2, row.Struct2)
}

如果表字段多不想手动罗列，可以用简单的字符串拼接自动生成带表前缀的字段列表，不需要逐个手写。

方案2：利用关联预加载自动处理冲突（有模型关联时优先用） #

如果两个模型已经定义了Gorm关联关系（外键关联），直接用Join模式的预加载，Gorm会自动处理重名字段的别名生成，完全不需要手动写字段映射：

var array1 []Struct1
// 假设Struct1内已经定义关联字段：Struct2 Struct2 `gorm:"foreignKey:关联字段"`
db.Model(&Struct1{}).
    Joins("Struct2"). // Gorm自动生成Join语句，自动处理重名字段
    Where("struct2.过滤字段 = ?", 条件值).
    Preload("Struct2").
    Find(&array1)

// 遍历array1即可拿到对应的Struct2数据
var array2 []Struct2
for _, item := range array1 {
    array2 = append(array2, item.Struct2)
}

方案3：逐行扫描自定义字段匹配（重名字段少的场景适用） #

不需要额外定义结构体，查询完成后调用Rows()方法逐行读取结果，手动指定两个表的字段扫描目标，完全绕开Gorm的默认同名字段匹配逻辑：

rows, _ := db.Model(&Struct1{}).
    Select("*").
    Joins("JOIN table2 ON 关联条件").
    Where("过滤条件").
    Rows()
defer rows.Close()

var array1 []Struct1
var array2 []Struct2
for rows.Next() {
    var s1 Struct1
    var s2 Struct2
    // 手动指定扫描目标，按SELECT返回的字段顺序对应即可
    db.ScanRows(rows, &s1)
    db.ScanRows(rows, &s2)
    array1 = append(array1, s1)
    array2 = append(array2, s2)
}

注意这个方案需要你自己对齐SELECT返回的字段顺序，避免扫描错位。

不要用连续调用两次Find()的写法，这种写法本质是拿同一个宽表结果集重复做两次结构体扫描，不仅会出现字段冲突，还会重复消费结果集导致数据异常。

内容的提问来源于stack exchange，提问作者TaQuangTu