GORM中Join的正确用法及关联查询结果映射问题咨询

针对你遇到的多表Join后无法通过Scan同时获取两个结构体字段，且嵌套结构体导致字段合并到同一张表的问题，以下是几种实用的解决方案：

1. 定义专用查询DTO结构体 #

创建一个仅用于接收Join查询结果的结构体，与原表结构解耦，通过gorm:"column"标签明确映射对应表的字段：

// 仅用于接收Join查询结果，不参与表创建
type TableJoinResult struct {
    Username string `gorm:"column:username"` // 两个表的username字段一致，直接映射
    Attr1    string `gorm:"column:attr1"`    // 对应table1的attr1
    Attr2    int    `gorm:"column:attr2"`    // 对应table2的attr2
}

查询时指定需要的字段并执行Scan：

var result TableJoinResult
db.Table("table1").
    Select("table1.username, table1.attr1, table2.attr2").
    Joins("JOIN table2 ON table1.username = table2.username").
    Where("table1.username = ?", "your_username").
    Scan(&result)

这种方式最清晰，完全避免表结构与查询结果的耦合，是生产环境的首选方案。

2. 嵌套结构体并禁用嵌入 #

如果想复用现有Table1和Table2结构体，可通过gorm:"embedded:false"标签阻止GORM将嵌套结构体的字段创建到主表中：

type Table1 struct {
    Username string `gorm:"primaryKey"` 
    Attr1    string
}

type Table2 struct {
    Username string `gorm:"primaryKey"`
    Attr2    int
}

// 用于Join查询的嵌套结构体，embedded:false避免字段合并到同一张表
type TableJoinModel struct {
    Table1
    Table2 `gorm:"embedded:false"`
}

查询时需明确指定字段，避免同名字段（如Username）的冲突：

var result TableJoinModel
db.Select("table1.username, table1.attr1, table2.attr2").
    Joins("JOIN table2 ON table1.username = table2.username").
    Where("table1.username = ?", "your_username").
    Scan(&result)

此方案兼顾了结构体复用与表结构独立性，适合需要频繁复用原结构体的场景。

3. 使用Map接收结果并手动赋值 #

对于临时查询场景，可直接用map[string]interface{}接收结果，再手动赋值到目标结构体：

var resultMap map[string]interface{}
db.Table("table1").
    Select("table1.username, table1.attr1, table2.attr2").
    Joins("JOIN table2 ON table1.username = table2.username").
    Where("table1.username = ?", "your_username").
    Scan(&resultMap)

// 手动映射到原结构体
var t1 Table1
var t2 Table2
t1.Username = resultMap["username"].(string)
t1.Attr1 = resultMap["attr1"].(string)
t2.Username = resultMap["username"].(string)
t2.Attr2 = resultMap["attr2"].(int)

该方案无需额外定义结构体，但需要处理类型断言，适合简单、临时的查询需求。

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