Node.js使用Mongoose操作MongoDB仅首次新增成功，后续报E11000重复键错误

问题复现场景 #

• 基于Node.js + Mongoose操作MongoDB的API，完成Schema、控制器编写后所有端点基础路由正常
• 首次POST请求可以正常向集合新增文档，返回和预期一致的MongoDB生成的文档结构
• 后续发起结构完全相同的POST请求，全部触发MongoError 11000错误
• 尝试切换多个Mongoose版本（5.11.15、5.11.17、5.11.18），问题始终存在

核心报错信息 #

接口返回的错误结构：

{
  "driver": true,
  "name": "MongoError",
  "index": 0,
  "code": 11000,
  "keyPattern": {
    "id": 1
  },
  "keyValue": {
    "id": null
  }
}

完整堆栈提示：E11000 duplicate key error collection: GithubProjects.projects index: id_1 dup key: { id: null }

问题根因 #

你定义的ProjectSchema中未声明id字段，但当前MongoDB集合中残留了一个针对id字段的唯一索引：

• 该索引来自历史版本的Schema代码：早期开发时曾在Schema中给id字段设置过unique: true约束，Mongoose自动运行时在数据库中创建了这个索引
• 后续修改Schema删除了id字段的定义后，Mongoose不会自动删除已经在数据库中创建完成的历史索引
• 新写入的所有文档都没有id字段，MongoDB会将所有缺失该字段的文档的id值统一判定为null
• 第一次写入时集合内没有id: null的记录，唯一索引校验通过；第二次及后续写入时，索引中已经存在一条id: null的记录，直接触发重复键冲突

解决操作步骤 #

1. 连接MongoDB实例，在对应的GithubProjects.projects集合下执行索引查询命令，确认残留索引：

// 在mongosh中执行
db.projects.getIndexes()

2. 删除残留的id_1唯一索引：

db.projects.dropIndex("id_1")

3. 完成删除后重新发起POST请求，即可正常执行新增操作

后续开发注意事项 #

• 修改Schema中涉及唯一索引的字段定义时，不要依赖Mongoose的自动索引同步能力，需要手动核对、清理数据库中废弃的历史索引
• 生产环境建议关闭Mongoose的自动建索引配置，避免非预期的索引创建影响线上库性能
• 控制器层捕获MongoError时，不要直接将原始错误对象返回给前端，建议根据错误码做结构化处理，比如针对11000类唯一索引冲突返回明确的字段重复提示

核对当前Mongoose模型对应的集合名是否和报错中访问的GithubProjects.projects匹配，避免因集合映射错误导致的跨集合索引异常。

内容的提问来源于stack exchange，提问作者João Casarin