自定义序列化器的大小写策略未被LINQ提供器识别的问题求助

问题本质 #

Cosmos SDK的LINQ查询提供器不会自动读取自定义CosmosSerializer中的序列化配置，它依赖独立的序列化规则生成查询语句的字段名。你用自定义序列化器实现了驼峰命名，但LINQ提供器仍默认用PascalCase生成查询字段，导致和存储的驼峰文档不匹配，返回空结果。

可行解决方案 #

方案1：为LINQ提供器配置匹配的命名解析器

给LINQ查询单独配置驼峰命名策略，让它生成和自定义序列化器一致的查询字段名：

// 自定义驼峰命名解析器
public class CamelCaseNameResolver : INameResolver
{
    public string Resolve(string name)
    {
        var contractResolver = new CamelCasePropertyNamesContractResolver();
        var mockProperty = new MockPropertyInfo(name);
        return contractResolver.GetResolvedPropertyName(mockProperty);
    }

    // 辅助类：模拟PropertyInfo供ContractResolver解析
    private class MockPropertyInfo : MemberInfo
    {
        private readonly string _name;
        public MockPropertyInfo(string name) => _name = name;
        public override string Name => _name;
        public override Type DeclaringType => typeof(object);
        public override Type ReflectedType => typeof(object);
        public override MemberTypes MemberType => MemberTypes.Property;
        public override object[] GetCustomAttributes(bool inherit) => Array.Empty<object>();
        public override object[] GetCustomAttributes(Type attributeType, bool inherit) => Array.Empty<object>();
        public override bool IsDefined(Type attributeType, bool inherit) => false;
    }
}

// 构建CosmosClient时配置LINQ命名解析器
var clientOptions = new CosmosClientOptions
{
    Serializer = new YourCustomNewtonsoftSerializer(), // 你的自定义序列化器
    LinqSerializerOptions = new CosmosLinqSerializerOptions
    {
        NameResolver = new CamelCaseNameResolver()
    }
};
var client = new CosmosClient(connectionString, clientOptions);

方案2：用官方暴露的Newtonsoft配置替代自定义序列化器

无需依赖SDK内部类的自定义序列化器，直接通过CosmosSerializationOptions配置多态和驼峰，LINQ提供器会自动读取此配置：

var clientOptions = new CosmosClientOptions
{
    SerializerOptions = new CosmosSerializationOptions
    {
        Serializer = new Newtonsoft.Json.JsonSerializerSettings
        {
            TypeNameHandling = Newtonsoft.Json.TypeNameHandling.Auto, // 支持多态
            ContractResolver = new Newtonsoft.Json.Serialization.CamelCasePropertyNamesContractResolver() // 驼峰命名
        }
    }
};
var client = new CosmosClient(connectionString, clientOptions);

这个方案更稳定，避免依赖SDK内部类的兼容性风险。

为什么JsonProperty特性未生效？ #

如果用的是System.Text.Json的[JsonPropertyName]，但自定义序列化器基于Newtonsoft.Json，特性不兼容；如果用的是Newtonsoft的[JsonProperty("camelCaseName")]，则是因为LINQ提供器未读取自定义序列化器的特性配置，必须通过LinqSerializerOptions.NameResolver或官方配置让LINQ识别特性规则。

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