如何在 Go 中使用 mgo 正确解析 MongoDB 查询结果-Golang-PHP中文网

如何在 Go 中使用 mgo 正确解析 MongoDB 查询结果

本文详解 Go 语言中使用 mgo 驱动解析 MongoDB 文档时常见的结构体标签错误，重点纠正 bson 标签中因多余空格导致字段无法反序列化的问题，并提供完整可运行示例与最佳实践。

本文详解 go 语言中使用 mgo 驱动解析 mongodb 文档时常见的结构体标签错误，重点纠正 `bson` 标签中因多余空格导致字段无法反序列化的问题，并提供完整可运行示例与最佳实践。

在 Go 中通过 mgo（v2）操作 MongoDB 时，结构体字段与 BSON 文档字段的映射完全依赖于 bson 结构体标签（struct tag）。一个看似微小的格式错误——如在 bson: 和 "fieldName" 之间插入空格——会导致整个字段反序列化失败，最终结构体字段保持零值（如空字符串），输出为 {} 或空白。

问题根源在于 Go 的 reflect.StructTag 解析规则：标签必须严格遵循 key:"value" 格式，key 与引号之间不允许有空格。原始代码中：

type Person struct {
    FirstName string `bson: "firstName" json: "firstName"` // ❌ 错误：bson: 后多了一个空格
    LastName  string `bson: "lastName json: "lastName"`    // ❌ 更严重：缺少闭合引号，且 bson 值未结束
}

上述写法被 Go 视为无效标签，mgo 无法识别 firstName 对应关系，因此所有字段均未赋值。

✅ 正确写法如下（注意冒号后无空格、引号闭合、多个 tag 用空格分隔）：

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

type Person struct {
    ID        bson.ObjectId `bson:"_id,omitempty"` // 推荐显式处理 _id
    FirstName string        `bson:"firstName" json:"firstName"`
    LastName  string        `bson:"lastName" json:"lastName"`
}

完整修复后的可运行示例：

package main

import (
    "fmt"
    "log"
    "gopkg.in/mgo.v2"
    "gopkg.in/mgo.v2/bson"
)

type Person struct {
    ID        bson.ObjectId `bson:"_id,omitempty"`
    FirstName string        `bson:"firstName" json:"firstName"`
    LastName  string        `bson:"lastName" json:"lastName"`
}

func main() {
    session, err := mgo.Dial("10.0.0.89")
    if err != nil {
        panic(err)
    }
    defer session.Close()

    session.SetMode(mgo.Monotonic, true)
    c := session.DB("PeopleDatabase").C("People")

    var people []Person
    err = c.Find(nil).All(&people)
    if err != nil {
        log.Fatal(err)
    }

    for _, p := range people {
        fmt.Printf("Name: %s %s\n", p.FirstName, p.LastName)
        // 输出示例：Name: George FakeLastName
    }
}

⚠️ 注意事项：