本文讲解如何通过合理定义 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 响应。
