MongoDB .NET Driver UUID存储异常及过时API替代方案咨询

一、两种配置的行为差异原因 #

1. BsonSerializer.RegisterSerializer的作用范围
   这个方法注册的是强类型Guid的全局序列化器，仅对代码中明确声明为Guid/IEnumerable<Guid>等强类型的字段生效（比如你的TestObject.Guids字段）。驱动在序列化这些字段时，能明确识别类型，会使用你注册的GuidSerializer(GuidRepresentation.Standard)将Guid序列化为UUID格式。

2. BsonDefaults.GuidRepresentation的作用范围
   这个静态全局配置是驱动的默认Guid表示方式，会影响所有无法明确识别类型的场景——比如你的Dictionary<string, object>中的"guid"字段，因为字段类型是object，驱动无法直接判断它是Guid，会 fallback 使用BsonDefaults中配置的默认格式。所以开启这个配置后，即使是object中的Guid也会按Standard（UUID）格式存储。

   官方标记它过时的原因是：静态全局配置在多线程、多MongoDB实例共存的场景下容易引发配置冲突，无法做到细粒度控制。

二、替代过时API的解决方案 #

方案1：通过MongoClientSettings全局配置（推荐） #

创建MongoClient时，在客户端设置中指定全局的Guid表示方式，覆盖默认行为，这样所有操作（包括object类型中的Guid序列化）都会遵循这个配置：

var connectionString = "mongodb://localhost:27017";
// 配置客户端全局Guid表示
var clientSettings = MongoClientSettings.FromConnectionString(connectionString);
clientSettings.GuidRepresentation = GuidRepresentation.Standard;

var client = new MongoClient(clientSettings);
// 后续数据库、集合操作沿用此配置
var database = client.GetDatabase("test");
var collection = database.GetCollection<TestObject>("guids");

方案2：集合级别的细粒度配置 #

如果只需要特定集合使用该Guid格式，可以在获取集合时单独配置：

var database = client.GetDatabase("test");
var collectionSettings = new MongoCollectionSettings
{
    GuidRepresentation = GuidRepresentation.Standard
};
var collection = database.GetCollection<TestObject>("guids", collectionSettings);

方案3：自定义object类型序列化器（复杂场景） #

如果需要更灵活的处理（比如仅针对特定object中的Guid序列化），可以自定义一个针对object类型的序列化器，识别并处理其中的Guid：

public class ObjectWithGuidSerializer : ObjectSerializer
{
    public override void Serialize(BsonSerializationContext context, BsonSerializationArgs args, object value)
    {
        if (value is Guid guid)
        {
            var guidSerializer = new GuidSerializer(GuidRepresentation.Standard);
            guidSerializer.Serialize(context, guid);
            return;
        }
        base.Serialize(context, args, value);
    }
}

// 注册该序列化器
BsonSerializer.RegisterSerializer(typeof(object), new ObjectWithGuidSerializer());

使用以上方案后，无需依赖过时的BsonDefaults，就能确保所有Guid（包括字典中object类型的Guid）都以UUID格式存储。

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