C# MongoDB Driver嵌套BsonDocument更新不生效问题求助

问题根源 #

MongoDB C# Driver的变更跟踪逻辑对强类型属性和BsonDocument的处理完全不同：

• 普通实体属性（如Prestige）：Driver通过属性的get/set拦截跟踪值变化，只要属性值修改，更新时会自动识别并同步。
• BsonDocument类型的嵌套字段（如Premium）：Driver默认只检测整个对象的引用是否变化。如果只是在已有BsonDocument实例里新增键值对，对象引用没改，Driver会判定该字段无变更，不会同步内部新增的字段到数据库。

解决办法 #

1. 强制更新BsonDocument引用 #

修改内部字段后，重新赋值一个新的BsonDocument实例，让引用发生变化：

// 原无效写法
user.Premium.Add("NewField", "TestValue");

// 有效写法
var newPremium = new BsonDocument(user.Premium);
newPremium.Add("NewField", "TestValue");
user.Premium = newPremium;

2. 克隆BsonDocument后修改 #

利用Clone()方法生成新实例，修改后赋值回去：

var cloned = user.Premium.Clone();
cloned.Add("NewField", "TestValue");
user.Premium = cloned;

3. 替换为强类型嵌套类 #

如果业务允许，把Premium改成强类型嵌套类，Driver会自动跟踪内部字段变化：

// 定义强类型嵌套类
public class PremiumSettings
{
    public bool IsEnabled { get; set; }
    public DateTime ExpireAt { get; set; }
    // 新增字段直接加属性
    public string NewFeature { get; set; }
}

// 修改UserMongo模型
public class UserMongo
{
    public ObjectId Id { get; set; }
    public PremiumSettings Premium { get; set; }
    // 其他属性...
}

4. 手动构建更新语句（动态场景推荐） #

如果必须保留BsonDocument的动态性，改用UpdateOneAsync手动指定更新字段：

await _userCollection.UpdateOneAsync(
    Builders<UserMongo>.Filter.Eq(u => u.Id, userId),
    Builders<UserMongo>.Update.Set("Premium.NewField", "TestValue")
);

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