手动指定_id仍触发MongoDB E11000重复键错误（提示_id为null）

我刚碰到过几乎一模一样的坑，咱们来一步步捋清楚问题根源和解决办法：

核心矛盾拆解 #

你明明用bson.NewObjectId()生成了有效的ObjectId赋值给_id，但MongoDB却报错说_id是null，这看起来离谱，但本质上大概率是结构体字段的序列化/反序列化或者实例复用出了问题，尤其是在用mgo驱动的场景下。

可能的原因及对应解决方案 #

1. 结构体实例被意外复用/字段重置 #

如果你在循环插入时复用了同一个结构体指针，比如：

doc := &YourStruct{}
for i := 0; i < 3; i++ {
    doc.ID = bson.NewObjectId()
    // 其他字段赋值
    err := collection.Insert(doc)
    // ...
}

这种情况下，驱动可能在第一次插入后对指针做了隐式修改，导致第二次插入时ID字段被意外重置为零值（也就是ObjectId("")，对应MongoDB里的null）。

解决办法：每次循环都创建新的结构体实例，确保每次插入的都是独立对象：

for i := 0; i < 3; i++ {
    doc := &YourStruct{
        ID: bson.NewObjectId(),
        // 其他字段按需赋值
    }
    // 打印整个结构体，确认ID确实是有效值
    fmt.Printf("Inserting doc: %+v\n", doc)
    err := collection.Insert(doc)
    if err != nil {
        log.Fatal(err)
    }
}

2. bson序列化的隐性问题 #

你的结构体字段定义是：

ID bson.ObjectId `json:"_id" bson:"_id"`

看起来没问题，但有些旧版本的mgo驱动在处理自定义_id时存在序列化bug，比如连续插入时的字段映射异常。

解决办法：

• 升级mgo驱动到最新稳定版；
• 尝试给bson标签加上omitempty反向验证（虽然你已经赋值了，但可以排除驱动误判零值的情况）：

  ID bson.ObjectId `json:"_id" bson:"_id,omitempty"`
  

3. 插入前字段验证不充分 #

你只打印了_id字段，但有可能在赋值后到插入前的某个环节，ID字段被其他代码意外覆盖成零值了。

解决办法：打印整个结构体实例（而不是单个ID字段），确认插入前ID确实是你生成的有效ObjectId，而不是ObjectId("")。

4. 数据库索引的额外检查 #

虽然报错指向的是默认_id索引，但可以用MongoDB Shell执行以下命令确认索引状态：

db.yourCollection.getIndexes()

确保_id索引是唯一的默认索引，没有其他包含_id的复合索引导致冲突（这个可能性较低，但可以彻底排除）。

我当时的解决经历 #

我之前就是因为循环里复用了同一个结构体指针，第一次插入后驱动隐式修改了指针内容，导致第二次插入时ID被重置为零值。改成每次创建新实例后，问题立刻就解决了。

你可以先从打印整个结构体入手，这是最快定位问题的办法。

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