怎样只更新目标文档的部分字段?
用明确过滤条件和更新操作符,例如 updateOne({_id: 1}, {$set: {...}})。不要把整份替换文档与局部字段更新混用,也不要拿空过滤条件去试生产集合。
历史正文停在 db.COLLECTION_NAME.,且混用旧 shell 的 update/save 写法。本页改用 MongoDB 8.0 文档中的 mongosh 更新 API,原始运行版本未知。
独立测试库中的复现步骤
在有写权限的本地一次性实例上执行;先确认测试库不会与现有数据重名。以下 JavaScript 可粘贴到 mongosh:
const demo = db.getSiblingDB("phase3_update_demo");
if (demo.getCollectionNames().length !== 0) {
throw new Error("请使用全新的测试库,不覆盖现有集合");
}
demo.items.insertOne({_id: 1, name: "old", count: 1});
const result = demo.items.updateOne(
{_id: 1},
{$set: {name: "new"}, $inc: {count: 2}}
);
printjson({matched: result.matchedCount, modified: result.modifiedCount});
printjson(demo.items.findOne({_id: 1}));
按文档预期匹配和修改计数都是 1,结果为 _id:1, name:"new", count:3;本批没有实际启动 MongoDB,不把预期写成实测输出。
边界
相同值重复 $set 时 matched 与 modified 可能不同;upsert 默认不启用。要更新多条应明确选择 updateMany 并先核对过滤条件。多文档业务不因单条更新原子性就自动成为一个事务。
下一步:切换数据库与真正创建数据。
整理范围与出处
本次依据下方版本资料整理说明与示例;历史导入资料的来源状态单独列示,不将技术参考认作原作者信息。原始发布日期与地址保留。