MongoDB E11000重复键错误排查：无重复文档却报错

这种“明明找不到重复文档却报重复键”的问题确实挺闹心的，结合你用Heroku+Mongoose+mLab的环境，以及正在配置不区分大小写约束的背景，我整理了几个最可能的原因和解决步骤：

1. 确认不区分大小写的索引配置是否生效 #

要实现不区分大小写的唯一约束，只设置unique: true是不够的——MongoDB默认索引是区分大小写的。必须在Schema里通过collation明确指定忽略大小写的规则：

// 示例：给目标字段添加不区分大小写的唯一索引
const yourSchema = new mongoose.Schema({
  targetField: {
    type: String,
    required: true,
    unique: true,
    // 核心配置：strength:2 表示忽略大小写差异
    collation: { locale: 'en', strength: 2 }
  }
});

如果之前已经创建过索引，修改Schema后需要手动更新索引：

# 先删除旧索引（替换成你的字段名）
db.yourCollection.dropIndex("targetField_1")
# 创建带collation的新索引
db.yourCollection.createIndex(
  { targetField: 1 }, 
  { collation: { locale: 'en', strength: 2 }, unique: true }
)

2. 用不区分大小写的查询排查隐藏重复 #

普通的find()是区分大小写的，你可能漏查了不同大小写的重复项。试试用正则查询：

# 替换成错误信息里的重复键值，比如错误显示dup key是"jasper"
db.yourCollection.find({ targetField: { $regex: /^jasper$/i } })

这个查询会匹配所有大小写变体（比如Jasper、JASPER等），确认是否真的存在隐藏的重复文档。

3. 修复索引与数据的不一致性 #

有时候文档被删除后，索引可能因为异常（比如服务意外中断）没有同步更新，导致索引里残留了重复键记录。这时候可以重建索引：

db.yourCollection.reIndex()

⚠️ 注意：这个操作会临时锁表，生产环境建议在低峰期执行，执行前最好先备份数据。

4. 检查是否存在空值重复 #

如果你的字段没有设置required: true，多个null值会触发唯一索引错误（MongoDB会把null视为一个有效键）。可以检查是否有多个文档的目标字段为null：

db.yourCollection.find({ targetField: null })

如果是这个问题，要么给字段加上required: true，要么调整索引规则（但后者可能不符合你的业务需求）。

5. 重启应用并验证索引配置 #

Mongoose会缓存模型定义，修改Schema的索引配置后，可能需要重启Heroku应用才能生效。重启后，在mongo shell里查看索引详情，确认collation是否正确应用：

db.yourCollection.getIndexes()

输出结果里应该能看到目标索引的collation字段和你设置的参数一致。

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