MongoDB使用聚合更新文档现有字段且不覆盖原有内容的实现方法

前置校验 #

先确认目标文档存在，执行以下命令查看匹配item:"drafts"的文档数量：
db.matrices.countDocuments({"item": "drafts"})
如果返回值为0，说明你的匹配条件有误，优先检查字段名大小写、值是否存在多余空格等问题。

分场景正确更新命令 #

场景1：warehouses是stock下的数组字段，需要追加新元素 #

不要使用$set直接赋值，否则会覆盖整个数组，根据需求选择对应运算符：

• 允许数组中存在重复值，使用$push
• 自动去重，相同值不会重复写入，使用$addToSet

示例命令：

// 只更新匹配到的第一条文档，追加新仓库数据
db.matrices.updateOne(
  {"item": "drafts"},
  {$push: {"stock.warehouses": {name: "北京仓", qty: 200}}}
)

// 更新所有匹配到的文档，自动去重
db.matrices.updateMany(
  {"item": "drafts"},
  {$addToSet: {"stock.warehouses": {name: "北京仓", qty: 200}}}
)

场景2：warehouses是stock下的普通字段，需要保留stock下其他原有字段 #

不要直接修改整个stock对象，使用点路径指定要更新的字段即可：

// 所有匹配文档保留stock下其他字段，仅新增/更新warehouses值
db.matrices.updateMany(
  {"item": "drafts"},
  {$set: {"stock.warehouses": "新的warehouses值"}}
)

常见更新成功但数据无变化的原因 #

• 使用了旧版update()方法未加multi: true配置，默认仅更新第一条匹配文档，推荐直接使用语义更明确的updateOne()/updateMany()方法避免歧义
• 字段路径大小写错误，MongoDB字段名大小写敏感，比如误写为Stock.warehouses会导致匹配不到目标字段
• 更新的内容和原有内容完全一致，此时modifiedCount会返回0，不会触发数据修改

结果验证 #

执行更新命令后查看返回值：

• matchedCount大于0：成功匹配到目标文档
• modifiedCount大于0：成功完成数据修改
  如果matchedCount为0，优先排查匹配条件的正确性。

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