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

本文解释了使用go语言和mgo驱动向mongodb插入结构体时仅生成空文档的常见原因：结构体字段未导出（即首字母小写），导致mgo无法访问和序列化字段值。

在Go语言中，只有首字母大写的字段才是导出（exported）字段，才能被其他包（如 mgo）通过反射机制读取和序列化。而原始代码中定义的 Result 结构体所有字段均为小写开头（nid, timestamp, hexhash, addr），属于非导出字段，因此 mgo 在执行 Insert() 时无法获取其值，最终只写入了默认的 _id 字段，其余字段被忽略——表现为 mongodb 中仅存空文档。

✅ 正确做法是将结构体字段改为大驼峰命名（public Exported Fields），并可选地通过 bson 标签明确指定数据库字段名，提升可维护性与兼容性：

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

创建实例时保持不变：

r := Result{     Nid:       hex_id,     Timestamp: int64(msg.timestamp.unix()),     Hexhash:   hexhash,     Addr:      msg.addr.String(), } fmt.Printf("Inserting: %+vn", r) // 调试建议：使用 %+v 查看字段名与值  err := h.c.Insert(r) if err != nil {     log.Fatal("Failed to insert into MongoDB:", err) }

⚠️ 注意事项：

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

• mgo（及后续的 mongo-go-driver）均依赖 Go 的反射机制，非导出字段永远不可见，无论是否添加 bson 标签；
• 若需保留 Go 变量命名习惯（如 CreatedAt 对应 created_at），务必配合 bson 标签映射，否则数据库字段名将默认为大驼峰（如 CreatedAt → createdat）；
• 建议为所有 BSON 字段添加 omitempty（如 `bson:”nid,omitempty”`）以避免零值字段意外写入；
• mgo 已归档，新项目推荐迁移到官方驱动 go.mongodb.org/mongo-driver/mongo，其序列化规则一致（仍要求字段导出）。

总结：Go 结构体写入 MongoDB 的前提不是“定义了字段”，而是“字段可被外部包导出并反射”。一次首字母大写的修正，即可解决 90% 的空文档插入问题。