Typescript/NodeJS中MongoDB已删_id仍间歇性抛E11000重复键错误

问题描述 #

在Typescript/NodeJS环境中，向MongoDB插入文档时会间歇性触发E11000重复键错误，具体场景和现象如下：

• 维护了一个存储应用状态的全局对象pools，状态变更时会作为带新时间戳的新条目写入MongoDB，操作每几秒执行一次
• 该状态对象本身未定义_id字段，但从MongoDB读取或插入后会自动被分配_id，且无法彻底移除
• 插入前已显式删除_id字段，但启动时必现错误，运行期间间歇性出现；控制台明明输出Insert with ID undefined，却仍报_id重复

插入代码 #

export async function updatePoolState(pools: State): Promise<boolean> {
  //@ts-ignore
  delete pools["_id"]
  //@ts-ignore
  console.log(`Insert with ID ${pools["_id"]}`)
  const success = (await poolDb.insertOne(pools)).acknowledged;
  return success;
}

错误日志 #

Insert with ID undefined

MongoServerError: E11000 duplicate key error collection: database.pools index: _id_ dup key: { _id: ObjectId('646eb8abff0f97eb6481f400') }

原因分析 #

1. 全局对象的引用复用问题：你操作的是全局对象的直接引用，delete pools["_id"]仅删除当前引用的_id属性，但如果该对象之前已被MongoDB添加过_id，后续可能因为其他异步逻辑（比如读取数据库后赋值给全局对象）重新给它带上_id；甚至在delete之后、insertOne之前，对象可能被其他代码修改，重新注入_id。
2. delete操作可能无效：MongoDB驱动自动添加的_id属性可能被设置为不可配置（configurable: false），此时delete操作无法真正移除该属性，控制台输出的undefined可能只是表面现象，实际对象仍携带_id。
3. 间歇性触发的核心：当全局对象在两次插入之间未被修改_id时，delete操作看似生效；但一旦有其他逻辑给全局对象重新赋值_id，就会触发重复键错误，这就是问题间歇性出现的原因。

解决方案 #

1. 创建对象副本，彻底切断全局引用 #

不要直接修改全局对象，而是创建一个新的副本，删除_id后再插入，避免引用复用带来的隐患：

export async function updatePoolState(pools: State): Promise<boolean> {
  // 浅拷贝对象，排除_id字段
  const poolToInsert = { ...pools };
  delete poolToInsert["_id"];
  
  console.log(`Insert with ID ${poolToInsert["_id"]}`);
  const success = (await poolDb.insertOne(poolToInsert)).acknowledged;
  return success;
}

如果State是嵌套对象，需要使用深拷贝：

// 用JSON序列化实现深拷贝（注意：无法处理函数、Symbol等特殊类型）
const poolToInsert = JSON.parse(JSON.stringify(pools));
delete poolToInsert["_id"];

也可以使用lodash.cloneDeep这类第三方工具实现更可靠的深拷贝。

2. 强制MongoDB生成新_id #

通过insertOne的选项强制服务器生成新的_id，忽略客户端传入的_id值，从根源避免重复：

export async function updatePoolState(pools: State): Promise<boolean> {
  // forceServerObjectId强制服务器生成新_id
  const success = (await poolDb.insertOne(pools, { forceServerObjectId: true })).acknowledged;
  return success;
}

3. 修正Typescript类型定义 #

给State接口添加可选的_id属性，去掉//@ts-ignore，让类型检查更严谨：

import { ObjectId } from 'mongodb';

interface State {
  // 你的其他业务属性
  timestamp: number;
  // ...其他字段
  _id?: ObjectId; // 添加可选的_id属性
}

这样就可以直接操作_id字段，无需忽略类型检查，也能提前发现潜在问题。

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