Golang中如何将SQL联查结果扫描到嵌套结构体中？

rows.StructScan() 默认无法自动识别嵌套结构体的字段映射，因为联查返回的是扁平的列集合，而你的结构体是层级嵌套的，字段名与数据库列名无法直接对应。以下是几种不用逐个扫描列的解决方案：

方案1：给嵌套结构体字段添加db标签映射列名 #

这是最直接的原生解决方案，无需依赖第三方库。你需要在结构体的每个字段上明确指定对应的数据库列名（包括嵌套的B、C结构体字段），同时确保SQL查询的列名（或别名）与标签完全匹配。

结构体定义示例： #

type C struct {
    ID   int    `db:"c_id"`
    Name string `db:"c_name"`
    AID  int    `db:"c_a_id"`
}

type B struct {
    ID   int    `db:"b_id"`
    Name string `db:"b_name"`
    AID  int    `db:"b_a_id"`
}

type A struct {
    ID   int    `db:"a_id"`
    Name string `db:"a_name"`
    B    *B     // 嵌套B指针
    C    *C     // 嵌套C指针
}

注意事项： #

如果联查存在列名冲突（比如A和B都有name字段），必须在SQL中给列添加别名，避免映射混乱：

SELECT 
    a.a_id, a.a_name,
    b.b_id, b.b_name, b.b_a_id,
    c.c_id, c.c_name, c.c_a_id
FROM A 
INNER JOIN B ON a.a_id = b.b_a_id 
INNER JOIN C ON c.c_a_id = a.a_id;

完成上述配置后，rows.StructScan()就能根据db标签自动将列值映射到嵌套结构体的对应字段中。

方案2：使用ORM库简化关联映射 #

如果不想手动维护标签与列名的对应关系，直接使用成熟的ORM库（如GORM），它原生支持关联查询并自动映射到嵌套结构体。

GORM实现示例： #

// 定义带GORM标签的结构体，关联表名与外键
type A struct {
    gorm.Model
    Name string
    B    *B `gorm:"foreignKey:AID;references:ID"`
    C    *C `gorm:"foreignKey:AID;references:ID"`
}

type B struct {
    gorm.Model
    Name string
    AID  uint
}

type C struct {
    gorm.Model
    Name string
    AID  uint
}

// 方式1：预加载关联数据
var a A
db.Preload("B").Preload("C").Where("id = ?", 1).First(&a)

// 方式2：直接JOIN查询
db.Joins("B").Joins("C").Where("a.id = ?", 1).First(&a)

GORM会自动处理联查逻辑与嵌套结构体的映射，省去手动编写SQL和扫描逻辑的麻烦。

方案3：自定义结构体扫描器（灵活但稍复杂） #

如果不想依赖第三方库，且需要更灵活的映射逻辑，可以让A结构体实现sql.Scanner接口，手动处理行数据的解析：

func (a *A) Scan(value interface{}) error {
    // 将数据库返回的行数据转为[]interface{}类型
    row, ok := value.([]interface{})
    if !ok {
        return fmt.Errorf("expected []interface{}, got %T", value)
    }

    // 按照SQL查询的列顺序，依次为A、B、C的字段赋值
    // 示例假设列顺序为：a_id, a_name, b_id, b_name, b_a_id, c_id, c_name, c_a_id
    a.ID = row[0].(int)
    a.Name = row[1].(string)
    
    a.B = &B{
        ID:   row[2].(int),
        Name: row[3].(string),
        AID:  row[4].(int),
    }
    
    a.C = &C{
        ID:   row[5].(int),
        Name: row[6].(string),
        AID:  row[7].(int),
    }

    return nil
}

实现接口后，直接调用rows.StructScan(&a)就会自动触发自定义的Scan方法完成映射。这种方式适合需要特殊映射逻辑的场景，但要确保列顺序与SQL查询完全一致。

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