MongoDB中有一类操作要求在查找文档的同时完成修改并返回结果，例如抢任务、取号、状态流转等场景。如果先用查询再更新，两个步骤之间存在时间窗口，并发场景下容易出现多个客户端操作同一条数据的问题。MongoDB为此提供了原子的findAndModify命令，以及驱动层封装的findOneAndUpdate等方法，本文将围绕这一主题展开详细讲解。
一、findAndModify的基本原理
findAndModify是MongoDB的一个数据库命令，它把查询和修改合并为一次原子操作。命令执行时，服务端会根据query条件定位文档，如果指定了sort则按排序取第一条，然后应用update或remove操作，最后把文档返回给客户端。整个过程在服务端完成，不存在查询和更新之间的间隙，因此天然规避了并发竞争问题。
在mongo shell中可以直接调用db.runCommand执行该命令，也可以使用封装好的方法db.collection.findAndModify()。命令的常用字段包括：query指定查询条件，sort指定排序规则（决定多条匹配时取哪一条），update指定修改内容，remove表示删除，fields指定返回的字段，upsert指定不存在时是否插入，new指定返回修改前还是修改后的文档。
db.orders.findAndModify({
query: { status: "pending" },
sort: { createdAt: 1 },
update: { $set: { status: "processing", worker: "worker-01" } },
new: true
})上面的语句会从orders集合中取出创建时间最早的一条pending状态订单，将其状态改为processing，并返回修改后的文档。如果没有匹配的文档，则返回null。这种一次搞定查询加修改的语义，正是findAndModify的核心价值所在。
二、驱动方法findOneAndUpdate详解
在实际开发中，更多使用的是官方驱动封装的三个方法：findOneAndUpdate、findOneAndReplace和findOneAndDelete。它们分别对应更新、替换和删除并返回文档，底层都基于findAndModify命令实现。
以Node.js驱动为例，findOneAndUpdate的第三个参数是选项对象，其中最重要的几个选项需要重点理解。returnDocument取值'before'或'after'，决定返回修改前还是修改后的文档，默认是before，这一点与很多开发者的直觉相反，需要特别注意。upsert为true时，如果没找到匹配文档会执行插入。projection可以裁剪返回字段，减少网络传输。sort在多个文档匹配时决定操作哪一条。
const result = await db.collection('counters').findOneAndUpdate(
{ _id: 'orderSeq' },
{ $inc: { seq: 1 } },
{
upsert: true,
returnDocument: 'after',
projection: { seq: 1 }
}
);
console.log('新的序号：', result.seq);这段代码实现了一个全局计数器：第一次调用时自动插入文档并得到序号1，之后每次调用序号加一并返回新值。由于整个操作是原子的，即使有大量并发请求，也不会出现序号重复的情况，这是分布式系统生成有序ID的常见方案。
三、典型应用场景与注意事项
findAndModify最常见的场景是任务队列。多个worker进程同时从队列取任务，如果使用find加update两步操作，两个worker可能查到同一条任务。改用findOneAndUpdate配合查询条件即可保证一个任务只会被一个worker取走。
// 抢占一条待处理任务，只有状态匹配才能成功
const task = await db.collection('tasks').findOneAndUpdate(
{ status: 'waiting' },
{ $set: { status: 'running', owner: workerId, startTime: new Date() } },
{ sort: { priority: -1, createTime: 1 }, returnDocument: 'after' }
);
if (!task) {
console.log('队列为空，没有可执行的任务');
}使用时还需要注意几点。第一，findAndModify一次只操作一条文档，如果需要批量修改请使用updateMany。第二，update内容使用更新操作符时遵循普通更新的规则，例如$set、$inc、$push等。第三，写关注级别可以通过writeConcern选项指定，对数据安全要求高的场景建议使用{ w: 'majority' }。第四，findAndModify本质上不是聚合管道的阶段，如果需要在聚合流程中完成查找修改，可以在管道末端使用$merge阶段把结果写回集合，两者结合可以处理更复杂的数据加工任务。
总结来说，findAndModify系列方法以原子性为最大卖点，适合所有先查后改且存在并发风险的场景。掌握returnDocument的方向、upsert的插入语义以及sort的选取规则，就能在取号、抢锁、任务分发等业务中写出既简洁又可靠的代码。
MongoDB聚合管道findAndModify修改时间：2026-09-02 16:16:46