Go使用官方MongoDB驱动插入对象数组出现双层嵌套数组问题

两层数组嵌套是代码笔误+类型不匹配导致的序列化异常：

• 结构体标签语法错误：MessageRecords的Sender字段的bson/json标签缺失闭合反引号，MongoDB驱动无法正确识别字段序列化规则，出现结构解析偏差
• 类型不匹配：定义的Records是[]MessageRecords值类型切片，但初始化的mRecords是*MessageRecords指针类型，直接append指针到值切片无法通过编译，实际运行的代码大概率临时将Records设为[]interface{}类型，append时误将切片作为元素传入，最终生成二维嵌套结构
• 语法错误：给primitive.ObjectID类型字段直接传普通字符串不符合类型要求，无法正常序列化
• 特殊排查点：如果修正上述问题后仍出现嵌套，检查Records字段是不是手滑写成了[][]MessageRecords二维切片类型

1. 修正结构体定义 #

补全缺失的标签闭合反引号，给Records字段加上明确的序列化标签，统一切片元素类型：

type MessageRecords struct {
    Sender  primitive.ObjectID `json:"sender" bson:"sender"` // 补全末尾的闭合反引号
    Message string             `json:"message" bson:"message"`
}

type Room struct {
    ID      primitive.ObjectID `json:"_id" bson:"_id"`
    Records []MessageRecords   `json:"records" bson:"records"` // 明确添加序列化标签，保持值类型切片即可
}

2. 修正首次插入逻辑 #

消息记录直接用值类型初始化，ObjectID用专用方法转换，禁止传入裸字符串：

// 注意：传入的ID必须是24位十六进制格式字符串，否则会转换失败
senderID, err := primitive.ObjectIDFromHex("62a54f3a21d65a43a21acac")
if err != nil {
    panic(err)
}

// 直接初始化值类型，不需要取地址生成指针
mRecords := MessageRecords{
    Sender:  senderID,
    Message: "This is a dummy message",
}

var room Room
room.ID = primitive.NewObjectID()
room.Records = append(room.Records, mRecords)

// 调用官方驱动的Collection方法指定集合名，不要直接用db.集合名的非标准写法
_, err = db.Collection("room").InsertOne(ctx, room)
if err != nil {
    panic(err)
}

插入后得到的就是预期的单层数组结构：

{
  "_id": {"$oid": "生成的房间ID"},
  "records": [
    {
      "sender": {"$oid": "62a54f3a21d65a43a21acac"},
      "message": "This is a dummy message"
    }
  ]
}

3. 后续追加元素的正确写法 #

不要每次查询全量文档修改后再整体替换，直接用$push操作符更新，效率更高也不会出现结构错乱：

// 构造待追加的新消息
newRecord := MessageRecords{
    Sender:  senderID,
    Message: "second message",
}

// 按房间ID匹配目标文档，往records数组末尾追加新元素
filter := bson.M{"_id": room.ID}
update := bson.M{"$push": bson.M{"records": newRecord}}

_, err = db.Collection("room").UpdateOne(ctx, filter, update)
if err != nil {
    panic(err)
}

存量异常数据处理：如果之前已经插入了二维嵌套的脏数据，需要先手动将存量数据的嵌套数组展开一层，再用修正后的逻辑写入，否则查询时仍会读到异常结构。

内容的提问来源于stack exchange，提问作者Georgehn66