Go 程序向 MongoDB 插入结构体时，若字段未导出或缺少 BSON 标签，会导致数据丢失（如仅 title 存入而 other_feature 消失）；正确做法是确保字段首字母大写（导出）、显式声明 bson 标签，并注意嵌套类型序列化兼容性。
go 程序向 mongodb 插入结构体时，若字段未导出或缺少 bson 标签，会导致数据丢失（如仅 `title` 存入而 `other_feature` 消失）；正确做法是确保字段首字母大写（导出）、显式声明 `bson` 标签，并注意嵌套类型序列化兼容性。
在 Go 中使用官方 go.mongodb.org/mongo-driver/bson 驱动操作 MongoDB 时，结构体字段能否被正确序列化并持久化到数据库，取决于两个关键条件：字段必须可导出（即首字母大写），且推荐显式指定 bson struct tag 以控制字段名映射与序列化行为。
以下是一个典型错误示例及其修复：
❌ 错误定义（字段小写 → 不可导出 → BSON 序列化器忽略）：
type A struct {
feature []string // 小写，不可导出 → 不会写入数据库
}
type B struct {
title string // 同样不可导出
other_feature []A // 即使嵌套，父字段不可导出则整个字段被跳过
}
✅ 正确定义（导出 + 显式 BSON 标签）：
type A struct {
Feature []string `bson:"feature"` // 导出字段 + 映射为 "feature"
}
type B struct {
Title string `bson:"title"` // 映射为 "title"
OtherFeature []A `bson:"other_feature"` // 推荐使用驼峰转蛇形命名惯例
}
? 注意：OtherFeature 字段名本身是导出的（大写 O），而 bson:"other_feature" 控制其在 MongoDB 文档中的键名，二者解耦——这是最佳实践。
插入示例：
doc := B{
Title: "Example Document",
OtherFeature: []A{
{Feature: []string{"x", "y"}},
{Feature: []string{"z"}},
},
}
_, err := collection.InsertOne(context.TODO(), doc)
if err != nil {
log.Fatal(err)
}
对应 MongoDB 中将生成如下文档：
{
"_id": ObjectId("..."),
"title": "Example Document",
"other_feature": [
{ "feature": ["x", "y"] },
{ "feature": ["z"] }
]
}
? 重要注意事项：
- 所有需持久化的字段（包括嵌套结构体中的字段）必须导出，否则 BSON 编码器无法访问，静默跳过；
- bson tag 中的字段名默认区分大小写，建议统一使用小写+下划线风格（如 other_feature），便于与其他语言驱动兼容；
- 若结构体字段可能为空（nil slice），MongoDB 会存为 null；如需存空数组 []，请初始化 OtherFeature: []A{}；
- 嵌套结构体 A 本身无需额外注册，只要其所有字段满足导出+tag 规则，即可自动递归序列化。
总结：Go 的结构体序列化依赖语言可见性规则。牢记“大写字母开头 + bson tag 显式声明”这一黄金组合，即可稳健支持任意深度的嵌套、切片及混合结构体在 MongoDB 中的存储与检索。
