Microsoft.AspNetCore.OData中如何用ODataQueryOptions处理小写驼峰式参数？

我之前也碰到过类似的情况，在使用Microsoft.AspNetCore.OData 7.0.0-beta2时，虽然配置了builder.EnableLowerCamelCase()，但ODataQueryOptions默认还是会按照CLR实体类的帕斯卡命名属性来解析查询参数，导致小写驼峰的参数无法被正确识别。下面是几个可行的解决思路：

1. 确保Edm模型正确生成小写驼峰属性 #

有时候EnableLowerCamelCase()的自动转换在beta版本中可能没有完全生效，需要显式配置实体属性的名称映射：

public IEdmModel GetEdmModel()
{
    var builder = new ODataConventionModelBuilder();
    // 启用小写驼峰命名约定
    builder.EnableLowerCamelCase();
    
    // 配置实体集并显式指定属性的小写名称（如果自动转换失效）
    var myEntitySet = builder.EntitySet<MyEntity>("myentities");
    myEntitySet.EntityType.Property(e => e.Id).Name = "id";
    myEntitySet.EntityType.Property(e => e.Name).Name = "name";
    // 其他属性同理
    
    return builder.GetEdmModel();
}

然后在Startup的服务配置中使用这个模型：

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers()
        .AddOData(options =>
        {
            options.AddRouteComponents("odata", GetEdmModel())
                   .Select().Filter().OrderBy().Expand().Count().SetMaxTop(null);
        });
}

2. 自定义命名约定类（如果自动约定不生效） #

如果EnableLowerCamelCase()的内置约定有问题，可以自定义一个命名约定类来强制转换属性名：

public class LowerCamelCaseCustomConvention : INamingConvention
{
    public string ConvertPropertyName(string propertyName)
    {
        if (string.IsNullOrWhiteSpace(propertyName))
            return propertyName;
        // 将首字母转为小写，其余保持不变
        return char.ToLowerInvariant(propertyName[0]) + propertyName.Substring(1);
    }

    public string ConvertEntitySetName(string entitySetName)
    {
        return ConvertPropertyName(entitySetName);
    }

    // 按需实现其他接口方法，比如ConvertEntityTypeName、ConvertComplexTypeName等
    public string ConvertEntityTypeName(string entityTypeName) => entityTypeName;
}

然后在构建模型时使用这个自定义约定：

public IEdmModel GetEdmModel()
{
    var builder = new ODataConventionModelBuilder(new LowerCamelCaseCustomConvention());
    builder.EntitySet<MyEntity>("myentities");
    return builder.GetEdmModel();
}

3. 升级到稳定版本（优先推荐） #

7.0.0-beta2属于预览版本，可能存在一些未修复的bug。建议尝试升级到Microsoft.AspNetCore.OData的正式稳定版本（比如7.0.0或更高），后续版本中对小写驼峰命名的支持更加完善，很多类似的大小写映射问题都已经被修复。

临时hack方案（不推荐） #

如果以上方法都无法临时解决，可以手动处理查询参数的大小写转换，比如在控制器中获取原始查询字符串，替换小写属性名为CLR的帕斯卡名称，再重新构建ODataQueryOptions：

public async Task<IEnumerable<MyEntity>> Get(ODataQueryOptions<MyEntity> options, HttpRequest request)
{
    // 手动替换查询参数中的小写属性名
    var modifiedQuery = request.QueryString.Value.Replace("id", "Id").Replace("name", "Name");
    // 重新构建查询选项（需要额外处理，仅作临时应急）
    var newQueryOptions = new ODataQueryOptions<MyEntity>(options.Context, new HttpRequestMessage { RequestUri = new Uri(request.Scheme + "://" + request.Host + request.Path + modifiedQuery) });
    
    // 后续逻辑...
}

这个方法比较繁琐且容易出错，只建议作为临时应急方案。

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