MongoDB中UpdateOneAsync是否锁定文档？并发下单字段特定值单次更新

咱们先直接回答你的核心问题：MongoDB 在执行 UpdateOneAsync 时，会对目标文档施加文档级锁（默认的 WiredTiger 存储引擎下）。这个锁会在整个更新操作期间持有，操作完成后立即释放，而且只会锁定你要更新的那单个文档，不会影响其他文档的读写。

针对你的并发更新需求：确保字段仅能以特定值更新一次 #

你的场景是：文档初始时 SomeField 为 null，需要保证它只能被设置为指定的 value 一次，之后不管并发请求怎么来，都不能被改成其他值（或者重复设置同一个值也没问题，取决于你的具体需求）。

你的代码思路其实已经踩对了关键点——用过滤条件限制只有满足状态的文档才会被更新，再结合 MongoDB 更新操作的原子性，就能完美解决并发问题。

完整代码示例（分两种场景）

场景1：仅允许从 null 改为指定 value 一次（之后不能再修改，哪怕是同一个值）

public async Task<bool> SetSomeField(string id, string value)
{
    // 过滤条件：仅匹配 ID 正确且 SomeField 还是 null 的文档
    var filter = Builders<SomeDocument>.Filter.And(
        Builders<SomeDocument>.Filter.Eq(x => x.Id, id),
        Builders<SomeDocument>.Filter.Eq(x => x.SomeField, null)
    );

    // 更新操作：将 SomeField 设置为目标值
    var update = Builders<SomeDocument>.Update.Set(x => x.SomeField, value);

    var updateResult = await GetCollection().UpdateOneAsync(filter, update);

    // ModifiedCount > 0 说明成功完成了第一次设置；否则说明字段已经被设置过了
    return updateResult.ModifiedCount > 0;
}

场景2：允许重复设置同一个 value，但不允许改成其他值

如果你希望之后重复设置同一个 value 也能成功（虽然不会实际修改文档），但绝不允许改成其他值，可以用你最初的过滤逻辑：

public async Task<bool> SetSomeField(string id, string value)
{
    var filter = Builders<SomeDocument>.Filter.And(
        Builders<SomeDocument>.Filter.Eq(x => x.Id, id),
        Builders<SomeDocument>.Filter.Or(
            Builders<SomeDocument>.Filter.Eq(x => x.SomeField, null),
            Builders<SomeDocument>.Filter.Eq(x => x.SomeField, value)
        )
    );

    var update = Builders<SomeDocument>.Update.Set(x => x.SomeField, value);

    var updateResult = await GetCollection().UpdateOneAsync(filter, update);

    // 如果是第一次设置，ModifiedCount > 0；重复设置时 ModifiedCount 为 0，但逻辑上也算"成功"
    // 这里可以根据你的需求调整返回值逻辑
    return updateResult.MatchedCount > 0;
}

为什么这个逻辑在并发下安全？ #

MongoDB 的 UpdateOneAsync 是原子操作，再加上文档级锁的保障：

1. 当多个并发请求同时尝试更新同一个文档时，MongoDB 会保证同一时间只有一个请求能拿到文档锁，执行更新操作。
2. 第一个成功执行的请求会把 SomeField 设置为 value，之后其他请求的过滤条件就不再匹配（要么 SomeField 不再是 null，要么不等于目标 value），所以这些请求会返回 ModifiedCount = 0，不会对文档做任何修改。
3. 整个过程不需要你手动加额外的锁，MongoDB 本身的机制就帮你处理了并发冲突。

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