Go 中嵌套 JSON 结构生成数组字段方法

本文讲解如何通过合理定义 Go 结构体及其 JSON 标签，将 MongoDB 查询结果序列化为包含自定义键名（如 "array"）的嵌套 JSON 对象，避免因字段名、嵌入方式或导出规则导致的序列化失败。

本文讲解如何通过合理定义 Go 结构体及其 JSON 标签，将 MongoDB 查询结果序列化为包含自定义键名（如 `"array"`）的嵌套 JSON 对象，避免因字段名、嵌入方式或导出规则导致的序列化失败。

要生成形如 {"array": [{"Name":"ethan","Grade":2}, ...]} 的 JSON 输出，关键在于三点：结构体字段必须可导出（首字母大写）、JSON 标签需精确匹配目标键名、外层结构体应显式封装切片字段并命名。

首先，修正原始代码中的问题：

• student 是小写字段 → 不可被 json.Marshal 序列化（Go 中非导出字段会被忽略）；
• studentData 的 BSON 标签与 JSON 需求不一致，应按输出目标单独设置 json 标签；
• 外层结构体不应使用匿名字段或错误的字段名（如 student []studentData），而应定义具名字段（如 Array）并绑定 json:"array"。

以下是推荐的结构体定义：

type Student struct {
    Name  string `json:"name"`  // 注意：此处按需求输出小写 "name"
    Grade int    `json:"Grade"` // 保持大写 "Grade"（与示例一致）
}

type StudentsResponse struct {
    Array []Student `json:"array"`
}

使用示例（整合 MongoDB 查询场景）：

// 假设已从 MongoDB 获取 []studentData 切片
var mongoData []studentData
err := collection.Find(ctx, bson.M{}).All(ctx, &mongoData)
if err != nil {
    log.Fatal(err)
}

// 转换为可序列化的 Student 切片
students := make([]Student, len(mongoData))
for i, d := range mongoData {
    students[i] = Student{
        Name:  d.Name,
        Grade: d.Grade,
    }
}

// 封装进响应结构体
response := StudentsResponse{Array: students}

// 序列化输出
jsonData, err := json.Marshal(response)
if err != nil {
    log.Fatal(err)
}
fmt.Println(string(jsonData))
// 输出：{"array":[{"name":"ethan","Grade":2},{"name":"rangga","Grade":2}]}

⚠️ 注意事项：

• 所有参与 JSON 序列化的字段必须是导出字段（首字母大写），否则 json.Marshal 会静默忽略；
• json 标签中的键名区分大小写，"name" 和 "Name" 效果不同，请严格对照期望输出；
• 若需兼容 MongoDB BSON 解析与 JSON 输出，可为同一字段同时声明 bson 和 json 标签，例如：

  Name string `bson:"name" json:"name"`

• 切勿使用匿名结构体字段或未导出字段作为顶层容器，这会导致空对象 {} 或 panic。

通过以上结构设计与转换逻辑，即可稳定、清晰地生成符合 API 规范的嵌套 JSON 响应。