insertMany 必须显式配置 ordered、writeConcern 和连接池参数,否则易卡死或丢数据;ordered: false 保证部分失败不影响其余插入,writeConcern: { w: 1, j: false } 提升速度,连接池需调大并设 timeoutMS。

直接用 insertMany 就行,但默认配置下极大概率卡住、超时或丢数据——关键在批量大小、写关注和连接池配置。
为什么 insertMany 会卡死或部分失败?
常见现象:插入中途 hanging、抛 NetworkError 或 WriteConcernError、返回的 insertedCount 少于实际文档数。根本原因不是函数本身慢,而是:
- MongoDB 驱动默认一次发太多文档(比如 5 万条),远超 socket 缓冲区和 WiredTiger 内存压力
- 默认
writeConcern: { w: "majority" },副本集同步慢时主节点干等,拖垮整批 - 连接池太小(默认
maxPoolSize: 10),高并发下连接争抢严重 - 没设
timeoutMS,单次失败可能挂住整个流程
insertMany 必须显式设置的三个参数
别依赖默认值,生产环境必须传 options 对象:
-
ordered: false:某条文档因重复键、类型错误等失败,其余继续执行;适合导入类场景 -
writeConcern: { w: 1, j: false }:只等主节点内存写入完成,不等 journal 刷盘;速度提升 2–3 倍,宕机丢失概率极低( -
timeoutMS: 30000:防挂死,30 秒无响应就报错退出,便于重试或降级
示例:collection.insertMany(docs, { ordered: false, writeConcern: { w: 1, j: false }, timeoutMS: 30000 })
怎么分批?每批多少条才稳?
别把 10 万条文档一次性塞进 insertMany。真实压测表明:
- 文档平均
- 文档含大字段(如 base64 图片、长文本)时,降到 300–500 条更安全
- 用
Array.prototype.slice()切 chunk,避免一次性加载全量到内存 - 串行提交(
for...of+await)比Promise.all()更可控;若需并发,用Promise.allSettled()限 3–5 批,并每批后加await new Promise(r => setTimeout(r, 10))微延时
什么时候该换 bulkWrite?
纯插入场景,insertMany 足够且更快。只有当你需要混合操作时才切:
- 同一请求里混 insert / upsert / update / delete
- 不同文档需不同
writeConcern(例如核心订单强一致性,日志弱一致性) - 要对每条操作单独捕获错误(
bulkWrite返回详细writeErrors数组)
注意:老版本驱动(bulkWrite 错误堆栈不友好,升级后再用。
真正容易被忽略的是:大批量写入前没关非必要索引,以及插入后没验证 insertedIds 是否与文档顺序/数量严格对应——尤其当 ordered: false 时,返回的 ID 数组可能缺位,得靠 result.upsertedCount + result.insertedCount 校验总数。











