如何在 Go 中正确将结构体保存到 MongoDB（避免空记录问题）

go 的 mongodb 驱动（如 mgo 或官方 driver）无法访问结构体的私有字段，若结构体字段首字母小写（如 nid），序列化时会被忽略，导致仅插入空文档。解决方法是将字段名首字母大写，使其导出（public），并可选添加 bson 标签以精确控制字段映射。

在 Go 语言中，结构体字段的可见性由其首字母大小写决定：首字母小写的字段是包私有的（unexported），外部包（包括 MongoDB 驱动如 mgo）无法反射访问或序列化它们。这正是你遇到“仅存入空记录”的根本原因——驱动看到的 Result 结构体所有字段均为不可见，因此跳过字段序列化，只生成默认的 _id 字段。

✅ 正确做法是将字段改为导出（首字母大写），并推荐显式声明 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(),
}
err := h.c.Insert(r)
if err != nil {
    log.Fatal("Insert failed:", err)
}

⚠️ 注意事项：

• 即使字段已导出，若未加 bson 标签，mgo 默认会按 驼峰转小写下划线 规则映射（如 Nid → nid），但显式声明更可靠、可读性更强；
• 若使用较新版本的官方 MongoDB Go Driver（go.mongodb.org/mongo-driver/mongo），同样遵循导出规则，且 bson 标签语法完全兼容；
• 切勿依赖 fmt.Println(r) 的输出判断序列化结果——它打印的是 Go 值本身，而非 BSON 编码后的内容；验证应通过数据库查询或启用驱动日志确认。

总结：Go 中与外部系统（如数据库、JSON API、gRPC）交互时，结构体字段必须导出（首字母大写）才能被反射机制识别。这是 Go 的基础设计原则，也是解决 MongoDB 空记录问题的关键前提。