本文讲解如何通过合理定义 Go 结构体及其 JSON 标签，将 MongoDB 查询结果序列化为形如 { "array": [ {...}, {...} ] } 的标准 JSON 格式，重点解决字段命名、嵌套层级与标签映射问题。
本文讲解如何通过合理定义 go 结构体及其 json 标签，将 mongodb 查询结果序列化为形如 {"array": [{...}, {...}]} 的标准 json 格式，重点解决字段命名、嵌套层级与标签映射问题。
要实现目标 JSON 结构：
{
"array": [
{ "Name": "ethan", "Grade": 2 },
{ "Name": "rangga", "Grade": 2 }
]
}
关键在于结构体定义必须与期望的 JSON 层级和键名严格对应，而非直接复用 MongoDB 的 BSON 标签逻辑。原始代码存在两个核心问题：
- 字段可见性错误：student []studentData 中 student 是小写首字母，导致该字段在 JSON 序列化时不可导出（Go 中首字母小写 = 包级私有）；
- 标签语义混淆：bson:"name" 和 json:"name" 混用，而目标 JSON 要求顶层键为 "array"，内部对象字段为 "Name"（大写 N）和 "Grade"（大写 G），需分别对齐。
✅ 正确做法是定义两个导出结构体，并精确控制 json 标签：
type Student struct {
Name string `json:"Name"` // 注意首字母大写 + 显式指定 "Name"
Grade int `json:"Grade"` // 同理，匹配目标字段名
}
type StudentsResponse struct {
Array []Student `json:"array"` // 顶层字段名为 "array"
}
使用示例（模拟从 MongoDB 获取数据后构造响应）：
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
// 假设从 MongoDB 查询得到 []studentData 切片
var dbResults []studentData = []studentData{
{Name: "ethan", Grade: 2},
{Name: "rangga", Grade: 2},
}
// 转换为可导出的 Student 切片
students := make([]Student, len(dbResults))
for i, v := range dbResults {
students[i] = Student{v.Name, v.Grade}
}
// 构造响应结构体
response := StudentsResponse{Array: students}
// 序列化
jsonData, err := json.MarshalIndent(response, "", " ")
if err != nil {
log.Fatal(err)
}
fmt.Println(string(jsonData))
输出即为：
{
"array": [
{
"Name": "ethan",
"Grade": 2
},
{
"Name": "rangga",
"Grade": 2
}
]
}
⚠️ 注意事项：
- MongoDB 驱动（如 mongo-go-driver）返回的文档通常需先解码到导出字段结构体（首字母大写），再按需映射到 JSON 响应结构体，避免直接复用 bson 标签结构体；
- 若需同时支持 BSON 解析与 JSON 输出，可为同一字段设置双标签：Name stringbson:"name" json:"Name"`；
- json.Marshal 默认忽略零值字段，如需保留（如 Grade: 0），无需额外处理；若需排除空字段，加 ,omitempty 即可；
- 实际 Web 服务中，建议将 StudentsResponse 作为 HTTP 响应体类型，配合 net/http 或 Gin 等框架直接 json.NewEncoder(w).Encode(response)。
通过清晰分离「数据存储结构」与「API 响应结构」，并精准控制 JSON 标签，即可稳定输出符合前端或第三方系统要求的嵌套 JSON 格式。
