MongoDB 2.2.22升级：无$set的updateOne行为匹配确认

核心结论 #

旧MongoDB 2.2.22配套的Node驱动中，不带$set操作符的updateOne（或当时的单文档update）行为完全等同于新版的replaceOne，而非带$set的updateOne。

行为对比 #

• 旧代码逻辑：this.ownDb.collection(collectionName)).updateOne(query, update, { upsert });

  • 查询匹配到文档时：用update完整替换匹配文档（原文档中未在update里出现的字段会被删除）
  • 查询无匹配且upsert: true时：直接插入update作为新文档

• 与两个候选写法的差异：

  1. 带$set的updateOne：updateOne(query, { $set:update }, { upsert });
     • 仅更新update中指定的字段，原文档其他字段保留，和旧代码的全量替换行为完全不同，会引入破坏性变更
  2. replaceOne(query, update, { upsert });
     • 匹配到文档则全量替换，无匹配则插入新文档，和旧代码行为100%一致

最小破坏性改造方案 #

直接将旧代码中的updateOne替换为replaceOne即可，无需修改query、update参数及upsert选项，完全保留原有业务逻辑。

验证方式（可选） #

可以通过简单测试确认：

1. 插入测试文档：db.collection.insertOne({ _id: 1, name: "old", extra: "data" })
2. 执行旧代码逻辑：updateOne({ _id: 1 }, { _id: 1, name: "new" }, { upsert: true })
3. 查看结果：若文档变为{ _id: 1, name: "new" }（extra字段被删除），则确认为替换行为，对应replaceOne

内容的提问来源于stack exchange，提问作者Dominic Böttger