Go 中 MongoDB 结构体字段为空的原因及正确序列化方法

在 Go 中操作 MongoDB 时，反序列化发现结构体字段全是空的，这种问题其实挺常见的。十有八九，根源在于字段没有导出——也就是首字母小写，导致 BSON 解析器根本没法碰它。

用 Go 的 mgo 或者官方驱动从 MongoDB 里读数据，结果结构体字段一片空白，最直接的原因通常就是字段没导出。首字母小写的字段在 Go 里是私有的，BSON 解析器那套反射机制根本访问不到，自然也就没法给它赋值。

Go 的反射机制，包括 mgo 和官方 mongo-go-driver 底层依赖的 bson 库，只能处理导出字段（首字母大写的字段）。如果你结构体里写的是 id、name 这种小写字段，它们就是私有成员，BSON 解析器无权写入。数据库里就算有 _id 和 nm 字段，反序列化之后拿到的依然是空字符串。

✅ 正确的做法是：把字段名改成首字母大写，再用 bson 标签精确映射到 MongoDB 里的字段名：

type StationConfig struct {
    ID   string `bson:"_id,omitempty"` // 映射 "_id"，omitempty 表示插入时可省略
    Name string `bson:"nm"`            // 映射 "nm" 字段
}

这里有个细节值得注意：_id 在 MongoDB 里是 ObjectID 类型。如果你需要完整的类型支持，比如后续查询、比较或者转成字符串，推荐用 primitive.ObjectID（官方驱动）或 bson.ObjectId（旧版 mgo）。以现代官方驱动为例，更严谨的定义是这样的：

import "go.mongodb.org/mongo-driver/bson/primitive"

type StationConfig struct {
    ID   primitive.ObjectID `bson:"_id,omitempty"`
    Name string             `bson:"nm"`
}

如果还在用已归档的 mgo.v2，那就用 bson.ObjectId：

import "gopkg.in/mgo.v2/bson"

type StationConfig struct {
    ID   bson.ObjectId `bson:"_id,omitempty"`
    Name string        `bson:"nm"`
}

⚠️ 几个关键点需要留意：

• 字段必须导出：id 改成 ID，name 改成 Name，否则反射不可见，这是硬性规定；
• 标签名要跟数据库字段严格对应：bson:"nm" 就意味着文档里必须有个叫 nm 的键；
• _id 的类型最好跟实际存储类型匹配：直接用 string 虽然也能工作（BSON 会尝试转换），但容易丢失类型语义和校验能力，长远看不是好习惯；
• omitempty 只影响序列化过程，比如插入或更新时忽略零值，对 Find 这类反序列化操作没有影响，按需保留即可。

最后给一个基于 mgo.v2 的完整示例，实际跑一下就能看到效果：

package main

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

type StationConfig struct {
    ID   bson.ObjectId `bson:"_id,omitempty"`
    Name string        `bson:"nm"`
}

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

    c := session.DB("metos").C("stations")

    var stationConfigs []StationConfig
    err = c.Find(nil).Limit(5).All(&stationConfigs)
    if err != nil {
        log.Fatal(err)
    }

    log.Printf("Found %d stations: %+v", len(stationConfigs), stationConfigs)
    // 输出示例：Found 5 stations: [{ID:ObjectIdHex("563c8d56819c3c91076b7c13") Name:"00000BE8"} ...]
}

总结一句话：Go 的结构体序列化，强依赖字段的可见性。记住“小写=私有=不可反射”这个原则，不只是 MongoDB，包括 JSON、XML、ORM 等所有基于反射的序列化场景，都能少踩很多坑。