Go语言中MongoDB结构体字段必须首字母大写才能被正确序列化

go语言中使用mgo等mongodb驱动保存结构体时，若结构体字段为小写（即非导出字段），则外部包无法访问这些字段，导致插入数据库时仅生成空文档（仅有`_id`字段）。解决方法是将所有需要持久化的字段名首字母大写，使其成为导出字段，并可选地通过`bson`标签明确指定字段映射关系。

在Go语言中，结构体字段的可见性由其首字母大小写决定：小写字母开头的字段是私有（unexported）的，仅在定义它的包内可见；而大写字母开头的字段是公有（exported）的，可被其他包（如 mgo）反射访问并序列化。你原始的 Result 结构体全部使用小写字段：

type Result struct {     nid       string  // ❌ 私有字段 → mgo无法读取     timestamp int64     hexhash   string     addr      string }

尽管你在本地 fmt.Println(r) 能正常打印（因为同包内可访问），但调用 h.c.Insert(r) 时，mgo 包无法反射获取这些字段值，因此实际写入mongodb的仅是一个空对象（仅自动生成 _id）。

✅ 正确做法是将字段改为导出形式，并推荐显式添加 bson 标签以控制数据库字段名（兼顾可读性与兼容性）：

type Result struct {     Nid       string `bson:"nid"`     Timestamp int64  `bson:"timestamp"`     Hexhash   string `bson:"hexhash"`     Addr      string `bson:"addr"` }

然后按原方式创建并插入：

立即学习“go语言免费学习笔记（深入）”；

r := Result{     Nid:       hex_id,     Timestamp: int64(msg.timestamp.unix()),     Hexhash:   hexhash,     Addr:      msg.addr.String(), } err := h.c.Insert(r) if err != nil {     log.Fatal("Insert failed:", err) }

? 额外注意事项：

• 若需保持Go字段命名规范（如 Nid 对应 MongoDB 中的 nid），bson 标签必不可少；否则字段将默认以大驼峰形式（如 Nid → “nid”）自动转为小写蛇形，但显式声明更可靠、可维护。
• 建议为 _id 字段单独添加支持（如使用 ObjectId 或字符串），例如：

  ID bson.ObjectId `bson:"_id,omitempty"`

• 使用 mgo 时，请确保已调用 session.Close() 并处理连接生命周期；生产环境建议迁移到官方驱动 go.mongodb.org/mongo-driver/mongo（mgo 已不再维护）。

遵循导出规则 + 显式 BSON 标签，即可确保结构体数据完整、准确地持久化到 MongoDB。