如何在C#中更新MongoDB文档，保留_id仅修改指定属性

首先，咱们先拆解下你当前代码的问题：

1. 过滤条件逻辑错误：你用Builders<UserObject>.Filter.Eq(s => s.Username, newUserName)作为匹配条件，但你要更新的就是Username字段啊！原文档的Username肯定不是newUserName，这个过滤器根本找不到目标文档，自然不会执行更新。
2. 误用ReplaceOneAsync：ReplaceOneAsync是用来替换整个文档的，你新创建的UpdatedUserObject没赋值_id，MongoDB会自动生成新的_id，直接覆盖原文档的唯一标识，完全不符合你保留_id和UserID的需求。
3. 未等待异步操作：调用ReplaceOneAsync时没加await，异步操作可能还没完成就结束了，也会导致更新失效。

正确方案：用UpdateOneAsync更新指定字段 #

咱们应该用UpdateOneAsync来仅修改需要更新的字段，同时保留原文档的_id和UserID。具体步骤如下：

1. 用唯一标识定位文档：用UserID（或_id）作为过滤条件，精准找到要更新的目标文档。
2. 构建字段更新定义：通过Builders<UserObject>.Update的Set方法，逐个指定要更新的字段和对应值。
3. 等待异步操作完成：给异步方法加上await，确保更新操作执行完毕。

以下是完整的修正代码：

var client = new MongoClient(DBString);
var database = client.GetDatabase("UserLists");
var collection = database.GetCollection<UserObject>(Convert.ToString(GuildId));

// 用UserID精准匹配目标文档
var filter = Builders<UserObject>.Filter.Eq(s => s.UserID, UserId);

// 构建仅更新指定字段的更新规则
var updateDefinition = Builders<UserObject>.Update
    .Set(s => s.Username, newUserName)
    .Set(s => s.CharClass, newCharClass)
    .Set(s => s.CharLevel, newCharLevel)
    .Set(s => s.CharColour, newCharColour);

// 执行更新，记得加await等待异步操作完成
await collection.UpdateOneAsync(filter, updateDefinition);

额外补充 #

• 如果你的业务场景中可能存在多个匹配文档（虽然UserID应该是唯一的），可以用UpdateManyAsync批量更新，但这里UpdateOneAsync更贴合需求。
• 如果你想确保只有文档存在时才执行更新，可以在UpdateOneAsync的参数里添加new UpdateOptions { IsUpsert = false }（这是默认值，可省略）；若设为true，则没有匹配文档时会自动插入新文档。

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