MongoDB双字段唯一复合索引创建后数据被覆盖问题排查

1. 验证组合唯一索引是否成功创建 #

先通过MongoDB Shell检查目标集合的索引状态，执行命令：

db.your_collection_name.getIndexes()

查看返回结果里是否包含{"object_id": 1, "object_type": 1}的唯一索引。如果不存在，说明索引创建逻辑有问题：

• 确认createIndexes方法是否在集合初始化阶段被正确调用
• 打印createIndexes返回的错误信息，排查索引失败原因（比如字段名错误、权限不足）

2. 检查结构体字段与数据库字段的映射 #

你插入代码里用的是ObjectID（大写ID），但索引定义的是object_id（小写下划线）。如果entity.TranslationForm结构体的字段没有正确设置bson标签，会导致插入文档的字段名和索引字段不匹配，索引完全失效。

确保结构体的bson标签和索引字段一致：

type TranslationForm struct {
    ObjectID       string    `bson:"object_id"`
    ObjectType     string    `bson:"object_type"`
    SourceLanguage string    `bson:"source_language"`
    TargetLanguage string    `bson:"target_language"`
    Content        string    `bson:"content"`
    ExpireAt       time.Time `bson:"expire_at"`
}

如果标签错误，插入的文档会用ObjectID作为字段名，而索引基于object_id，此时索引无法约束数据，甚至可能你看到的“覆盖”其实是插入了两条字段名不同的文档。

3. 确认插入操作的正确性 #

InsertOne本身是插入新文档的操作，不会覆盖已有数据。如果确实出现覆盖，大概率是业务代码里误用了UpdateOne并设置了Upsert: true，而非InsertOne。检查代码逻辑，确保没有用更新操作替代插入。

4. 手动测试索引约束 #

在MongoDB Shell里手动插入测试数据，验证索引是否生效：

db.your_collection_name.insertOne({"object_id": "abc", "object_type": "SAMPLE"})
db.your_collection_name.insertOne({"object_id": "abc", "object_type": "SAMPLE"})

第二条插入应该返回E11000 duplicate key error重复键错误。如果没有报错，说明索引未正确创建或字段映射不匹配。

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