使用Mongo LINQ Provider V3时，LINQ查询忽略枚举参数的自定义序列化问题

我太懂你这个头疼的问题了！之前帮朋友排查过类似的情况，核心就是V3版本的LINQ Provider在处理ushort这类基础数值类型的枚举时，会“自作主张”直接用枚举的底层数值生成查询条件，完全绕过了你配置的自定义字符串序列化逻辑，导致MongoDB里存的字符串和查询的数值对不上，自然查不到数据。

先给你理清楚问题根源：当枚举声明为ushort时，V3的LINQ Provider会默认把它当作数值类型来处理，而不是走你注册的自定义序列化器去转成字符串，这和V2的处理逻辑不一样，所以之前正常的代码升级后就出问题了。

下面给你几个实用的解决办法，按优先级来试：

1. 先确认自定义序列化器的注册是否到位 #

V3的LINQ Provider对全局序列化器的注册时机和方式要求更严格，你得确保序列化器是在MongoClient初始化之前就注册好的，比如：

// 在启动程序的最开始就注册
BsonSerializer.RegisterSerializer(typeof(MeasurementValueType), new MeasurementValueTypeSerializer());

// 或者在实体类的映射里明确指定
BsonClassMap.RegisterClassMap<YourEntity>(cm =>
{
    cm.AutoMap();
    cm.MapMember(x => x.YourEnumProperty)
      .SetSerializer(new MeasurementValueTypeSerializer());
});

如果是用依赖注入的方式配置MongoClient，一定要把序列化器注册放在注册MongoClient之前，不然驱动可能已经加载了默认的序列化逻辑。

2. 强制LINQ查询使用序列化后的字符串值 #

如果上面的注册还是没生效，那可以在查询时手动把枚举转换成序列化后的字符串，让LINQ Provider用字符串去匹配MongoDB里的存储值：

var targetEnum = MeasurementValueType.TargetValue;
// 用自定义序列化器把枚举转成字符串
var serializedValue = BsonSerializer.Serialize(targetEnum, typeof(MeasurementValueType)).AsString;
// 这里直接用字符串查询
var results = yourCollection.AsQueryable()
    .Where(x => x.YourEnumProperty.ToString() == serializedValue)
    .ToList();

或者更直接一点，用BsonValue来包装枚举值，让驱动走序列化逻辑：

var targetBson = BsonSerializer.Serialize(MeasurementValueType.TargetValue);
var results = yourCollection.AsQueryable()
    .Where(x => x.YourEnumProperty == targetBson)
    .ToList();

3. 调整MongoClient的LINQ设置 #

有时候V3的LINQ Provider会默认开启一些优化，导致绕过自定义序列化器，你可以在配置MongoClient的时候强制指定使用自定义的序列化器注册表：

var clientSettings = MongoClientSettings.FromConnectionString("你的连接字符串");
clientSettings.LinqProvider = LinqProvider.V3;
// 确保驱动使用你注册了自定义序列化器的注册表
clientSettings.SerializerRegistry = BsonSerializer.SerializerRegistry;

var client = new MongoClient(clientSettings);

如果是创建集合的时候，也可以显式指定序列化器注册表：

var collection = client.GetDatabase("你的数据库")
    .GetCollection<YourEntity>("你的集合", new MongoCollectionSettings
    {
        SerializerRegistry = BsonSerializer.SerializerRegistry
    });

4. 检查你的自定义序列化器实现 #

最后再确认下你的序列化器是不是正确处理了ushort枚举，比如正确继承EnumSerializer<T>并指定字符串类型，或者自定义序列化逻辑：

public class MeasurementValueTypeSerializer : EnumSerializer<MeasurementValueType>
{
    public MeasurementValueTypeSerializer() : base(BsonType.String)
    {
        // 构造函数指定用字符串存储枚举
    }

    // 如果有自定义的字符串映射（比如不是用枚举名），重写Serialize和Deserialize
    public override void Serialize(BsonSerializationContext context, BsonSerializationArgs args, MeasurementValueType value)
    {
        // 这里可以写自定义的字符串转换逻辑，比如用DescriptionAttribute的内容
        var stringValue = value.ToString();
        context.Writer.WriteString(stringValue);
    }

    public override MeasurementValueType Deserialize(BsonDeserializationContext context, BsonDeserializationArgs args)
    {
        var stringValue = context.Reader.ReadString();
        return Enum.Parse<MeasurementValueType>(stringValue);
    }
}

一般来说，按这个顺序试下来，问题应该就能解决了。核心就是要让V3的LINQ Provider意识到这个枚举应该用字符串来处理，而不是它默认的数值类型。

备注：内容来源于stack exchange，提问作者SJFJ