在go中使用mgo驱动向mongodb插入结构体时，若文档仅保存了_id而其余字段为空，根本原因是结构体字段未导出（即首字母小写），导致mgo无法通过反射访问和序列化这些字段。
在go中使用mgo驱动向mongodb插入结构体时，若文档仅保存了_id而其余字段为空，根本原因是结构体字段未导出（即首字母小写），导致mgo无法通过反射访问和序列化这些字段。
Go语言的反射机制（reflect package）仅能访问导出字段（exported fields），即字段名必须以大写字母开头。mgo底层正是依赖反射将结构体字段映射为BSON文档；若字段为小写（如 user_session_id_str），即使赋值有效，在序列化时也会被忽略，最终仅生成带默认_id的空文档。
✅ 正确做法：将所有需持久化的字段名首字母大写，并保持BSON标签（bson:）中的键名小写以匹配数据库约定：
type AN_Track_Log struct {
ID bson.ObjectId `bson:"_id,omitempty"`
UserSessionIDStr string `bson:"user_session_id_str"`
GoogleAnalyPixelIDStr string `bson:"googleanaly_pixel_id_str"`
PerfAudPixelIDStr string `bson:"perfaud_pixel_id_str"`
SiteIDStr string `bson:"site_id_str"`
MetricStr string `bson:"metric_str"`
ValueStr string `bson:"value_str"`
EventStr string `bson:"event_str"`
LocationIDStr string `bson:"location_id_str"`
RefererStr string `bson:"referer_str"`
TrackOriginStr string `bson:"track_origin_str"`
FingerprintStr string `bson:"fingerprint_str"`
// ... 其他字段同理
}⚠️ 注意事项：
- 字段名大小写变更后，务必同步更新所有赋值代码（如 p_track_log.UserSessionIDStr = "abc"）；
- bson: 标签中的字符串（如 "user_session_id_str"）决定存入MongoDB的字段名，与Go字段名无关，可自由设计为下划线风格或驼峰风格；
- 推荐使用更语义化的字段名（如 UserSessionIDStr 而非 User_session_id_str），提升代码可读性；
- 若项目已启用 golint 或 staticcheck，小写字段名会触发 exported method/field should have comment 类警告，导出后也便于生成文档；
- 补充：mgo 已不再维护，生产环境建议迁移到官方驱动 go.mongodb.org/mongo-driver/mongo，其对结构体字段可见性的要求一致（仍需导出字段），但API更现代、支持上下文取消与连接池优化。
完成字段导出改造后，插入逻辑即可正常工作：
立即学习“go语言免费学习笔记（深入）”；
p_track_log.ID = bson.NewObjectId()
err := p_mongodb_coll.Insert(p_track_log) // 注意：传值或传指针均可，但需确保字段已导出
if err != nil {
log.Fatal("Insert failed:", err)
}总结：Go的封装机制是双刃剑——它保障了包内安全，但也要求序列化库（如mgo、encoding/json、encoding/xml）严格依赖导出规则。牢记“小写=私有=不可反射=不可序列化”，是避免此类静默失败的关键。
