在Go语言项目里使用mgo库操作MongoDB时，ObjectId字段是最基础也最容易出问题的部分。很多同学把文档查出来之后，发现结构体里的ID字段不对，或者根本取不到值，这种情况大多和bson标签、字段类型以及mgo对ObjectId的处理机制有关。
常见异常表现
实际开发中，ObjectId解析异常通常有以下几种情况：
- 结构体字段值为零值，比如 bson.ObjectId("")
- 使用 bson.M 读取时，字段类型是 interface{}，断言成 string 或 bson.ObjectId 失败
- 插入时自动生成的 ID 在查询时无法对应到自定义字段
问题原因与排查思路
1. 结构体标签遗漏或写错
mgo依靠 bson 标签来完成字段映射。如果结构体里没有给 ID 字段加正确的标签，就会导致解析不到。
type User struct {
ID bson.ObjectId `bson:"_id"`
Name string `bson:"name"`
}
如果写成 `bson:"id"` 或者忘了写标签，MongoDB 里的 _id 就不会映射到 ID 字段。
2. 使用 string 类型接收 ObjectId
有些开发者习惯用 string 来定义 ID 字段，但 mgo 默认不会把 ObjectId 自动转成字符串，查询后字段就是空的。
// 错误示例
type User struct {
ID string `bson:"_id"`
Name string `bson:"name"`
}
// 正确示例
type User struct {
ID bson.ObjectId `bson:"_id"`
Name string `bson:"name"`
}
3. 查询时用了错误的解码方式
当使用 bson.M 接收结果时，ObjectId 的实际类型是 bson.ObjectId，直接当成 string 用会出错。
var m bson.M
err := collection.Find(nil).One(&m)
if err != nil {
panic(err)
}
// 正确断言方式
if id, ok := m["_id"].(bson.ObjectId); ok {
fmt.Println(id.Hex())
}
解决办法总结
| 问题 | 解决办法 |
|---|---|
| 字段映射不到 | 检查 bson 标签是否为 _id |
| ID 为空 | 字段类型使用 bson.ObjectId 而非 string |
| 类型断言失败 | 用 bson.ObjectId 做类型断言，再调用 Hex() |
完整示例
下面给出一个插入并查询 ObjectId 字段的完整示例：
package main
import (
"fmt"
"gopkg.in/mgo.v2"
"gopkg.in/mgo.v2/bson"
)
type User struct {
ID bson.ObjectId `bson:"_id"`
Name string `bson:"name"`
}
func main() {
session, err := mgo.Dial("127.0.0.1:27017")
if err != nil {
panic(err)
}
defer session.Close()
c := session.DB("test").C("users")
u := User{ID: bson.NewObjectId(), Name: "tom"}
c.Insert(u)
var result User
c.Find(bson.M{"name": "tom"}).One(&result)
fmt.Println("查询到的ID为:", result.ID.Hex())
}
只要保证字段类型、bson 标签和断言方式都正确，mgo库中 ObjectId 字段的解析异常基本都能解决。