如何在 Go 中将结构体嵌套到另一个结构体中实现 JSON 包裹-Golang-PHP中文网

如何在 Go 中将结构体嵌套到另一个结构体中实现 JSON 包裹

本文讲解如何通过定义嵌套结构体（如 RatingPK 包裹 Rating），使 Go 的 JSON 序列化输出符合 { "ratingsPK": { ... } } 的嵌套格式，而非扁平数组。

本文讲解如何通过定义嵌套结构体（如 `ratingpk` 包裹 `rating`），使 go 的 json 序列化输出符合 `{ "ratingspk": { ... } }` 的嵌套格式，而非扁平数组。

在 Go 中，若希望将一组原始数据对象（如 Rating）封装进一个“容器”结构体（如 RatingPK），并最终以 {"ratingsPK": {...}} 的 JSON 形式输出，关键在于正确设计结构体字段命名、类型及序列化行为，而非仅靠运行时赋值逻辑。

首先，需修正原始代码中的两个核心问题：

返回类型不匹配：原函数 searchUserRatings 声明返回 []Rating，但实际想构造的是 []RatingPK —— 必须同步更新返回类型；
JSON 字段名未显式声明：Go 的 json 包默认使用字段名小写形式（如 ratingsPK），但 JSON 规范要求首字母小写的字段无法被外部系统识别为合法键名（如 "ratingsPK"）。需通过 json tag 显式指定导出字段名。

✅ 正确做法如下：

// Rating 表示数据库中的一条评分记录
type Rating struct {
    MovieId   int       `json:"movieId"`
    UserId    int       `json:"userId"`
    RatingId  int       `json:"rating_id"`
    Rating    int       `json:"rating"`
    Timestamp time.Time `json:"timestamp"`
}

// RatingPK 是一个包装器，用于将单个 Rating 嵌入到名为 "ratingsPK" 的 JSON 字段中
type RatingPK struct {
    RatingsPK Rating `json:"ratingsPK"` // 注意：字段名首字母大写（导出），tag 指定 JSON 键为 "ratingsPK"
}

? 关键点：RatingsPK 字段必须是导出字段（首字母大写），且通过 json:"ratingsPK" 显式控制序列化后的键名；内部嵌套的 Rating 类型自动继承其自身的 json tag。

接着，更新查询函数，直接构建 []RatingPK 并返回：

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

func searchUserRatings(id string) []RatingPK {
    rows, err := db.Query("SELECT * FROM ratings WHERE userId = ?", id)
    if err != nil {
        log.Printf("DB query error: %v", err)
        return nil
    }
    defer rows.Close() // ✅ defer 应放在错误检查之后、循环之前，确保始终执行

    var results []RatingPK
    for rows.Next() {
        var r Rating
        // 注意字段顺序需与 SELECT * 严格一致；推荐显式列出字段以提高可维护性
        if err := rows.Scan(&r.MovieId, &r.UserId, &r.RatingId, &r.Rating, &r.Timestamp); err != nil {
            log.Printf("Scan error: %v", err)
            continue // 跳过单条错误，不中断整个查询
        }
        results = append(results, RatingPK{RatingsPK: r})
    }

    return results
}

调用示例与 JSON 输出验证：

func main() {
    ratings := searchUserRatings("2")
    data, _ := json.MarshalIndent(ratings, "", "  ")
    fmt.Println(string(data))
}

输出即为期望格式：

[
  {
    "ratingsPK": {
      "movieId": 93,
      "userId": 2,
      "rating_id": 593,
      "rating": 3,
      "timestamp": "0001-01-01T00:00:00Z"
    }
  },
  {
    "ratingsPK": {
      "movieId": 94,
      "userId": 2,
      "rating_id": 616,
      "rating": 3,
      "timestamp": "0001-01-01T00:00:00Z"
    }
  }
]

⚠️ 注意事项：

避免使用指针接收器 *RatingPK 配合 Init() 方法初始化——对于简单嵌套，直接字面量赋值（RatingPK{RatingsPK: r}）更清晰、零分配、无副作用；
defer rows.Close() 必须在 rows 创建后尽早声明（通常紧随 db.Query 后），否则可能因提前 return 导致资源泄漏；
若 time.Time 字段在数据库中可能为空，请使用 sql.NullTime 并自定义 json.Marshaler 实现安全序列化；
SELECT * 在生产环境不推荐，应明确列出所需字段并保持与 Scan 顺序一致，增强健壮性。