Go 程序向 MongoDB 写入结构体时，若字段未导出或缺少 BSON 标签，会导致数据丢失（如仅 title 存入而 other_feature 消失）；本文详解通过字段导出 + bson 标签实现嵌套切片的完整持久化。
go 程序向 mongodb 写入结构体时，若字段未导出或缺少 bson 标签，会导致数据丢失（如仅 `title` 存入而 `other_feature` 消失）；本文详解通过字段导出 + `bson` 标签实现嵌套切片的完整持久化。
在 Go 中使用官方 go.mongodb.org/mongo-driver/bson 包操作 MongoDB 时，结构体字段能否被序列化写入数据库，取决于两个关键条件：字段必须导出（即首字母大写），且建议显式声明 bson 字段标签以控制数据库中的键名。原始代码中 feature 和 other_feature 均为小写首字母，属于未导出字段，因此 BSON 编码器直接忽略它们，仅 title（虽也未导出，但示例中可能误写为大写或存在其他上下文）看似成功写入——实则因字段不可见而无法序列化。
✅ 正确做法如下：
type A struct {
Feature []string `bson:"feature"` // 导出字段 + 显式 bson 标签
}
type B struct {
Title string `bson:"title"` // 导出 + 标签
OtherFeature []A `bson:"other_feature"` // 推荐驼峰转下划线命名，保持语义清晰
}
? 注意：Other_feature 字段名本身不合法（含下划线且首字母小写），应改为 OtherFeature 并通过 bson:"other_feature" 控制序列化后的键名。这是 Go 命名规范与 MongoDB 字段习惯的常见结合方式。
完整插入示例：
import (
"context"
"log"
"go.mongodb.org/mongo-driver/bson"
"go.mongodb.org/mongo-driver/mongo"
"go.mongodb.org/mongo-driver/mongo/options"
)
// 初始化 client, collection 后...
doc := B{
Title: "Sample Document",
OtherFeature: []A{
{Feature: []string{"x", "y"}},
{Feature: []string{"z"}},
},
}
_, err := collection.InsertOne(context.TODO(), doc)
if err != nil {
log.Fatal(err)
}
执行后，MongoDB 中将准确存入：
{
"title": "Sample Document",
"other_feature": [
{ "feature": ["x", "y"] },
{ "feature": ["z"] }
]
}
? 关键注意事项：
- ❌ 不要使用小写首字母字段（如 feature），即使加了 bson 标签也无法导出；
- ✅ 所有需持久化的字段必须首字母大写（导出），并推荐搭配 bson:"xxx" 明确映射；
- ⚠️ 若结构体含指针、接口或自定义类型，需额外实现 bson.Marshaler/Unmarshaler；
- ? 可配合 omitempty 标签（如 bson:"feature,omitempty"）避免空切片写入 null 或空数组（依业务需求选择）。
遵循以上规范，即可稳定、可维护地将任意深度的嵌套结构体与切片存入 MongoDB。
