引入Microsoft.AspNet.OData.Versioning后如何配置OData URI端点大小写不敏感

这个问题我之前也碰到过——引入OData版本化组件后，原本正常的大小写不敏感路由突然失效了，核心原因是版本化的OData路由默认不会继承全局的大小写配置，得我们在版本化路由的配置里明确开启。

下面是具体的解决步骤，你可以直接对应到你的项目中：

1. 全局路由大小写不敏感配置（可选但推荐） #

先在WebApiConfig.cs的Register方法里，全局开启路由的大小写不敏感，确保基础路由规则一致：

public static void Register(HttpConfiguration config)
{
    // 全局设置路由忽略大小写
    config.Routes.IgnoreCase = true;

    // 其他WebApi基础配置...
}

2. 核心：版本化OData路由开启大小写不敏感 #

这是解决问题的关键步骤。在配置版本化OData路由时，需要通过ODataRouteSettings显式设置CaseInsensitive = true。示例代码如下：

public static void Register(HttpConfiguration config)
{
    // 1. 配置API版本化基础选项
    config.AddApiVersioning(options =>
    {
        options.ReportApiVersions = true;
        options.AssumeDefaultVersionWhenUnspecified = true;
        options.DefaultApiVersion = new ApiVersion(1, 0);
    });

    // 2. 构建OData模型（根据你的实体类型调整）
    var modelBuilder = new ODataConventionModelBuilder(config);
    modelBuilder.EntitySet<YourEntity>("Value"); // 对应你的ValueController

    // 3. 配置版本化OData路由，重点设置RouteSettings
    config.MapVersionedODataRoutes(
        routeName: "VersionedODataRoute",
        routePrefix: null,
        modelBuilder: (builder, apiVersion) =>
        {
            // 如果不同API版本有不同模型，可在这里根据apiVersion调整
            builder.EntitySet<YourEntity>("Value");
            return builder.GetEdmModel();
        },
        routeSettings: new ODataRouteSettings
        {
            CaseInsensitive = true // 开启OData路由的大小写不敏感
        });
}

3. 验证控制器与模型的命名匹配 #

确保你的控制器名称是ValueController（后缀必须为Controller），OData模型中配置的EntitySet名称为"Value"——因为我们开启了大小写不敏感，URI里的value或Value都会匹配到这个控制器。

失效原因说明 #

在未引入版本化组件时，MapODataServiceRoute默认会继承全局路由的大小写设置，但MapVersionedODataRoutes是独立的路由配置体系，默认没有开启大小写不敏感，必须显式指定ODataRouteSettings才能恢复原来的行为。

现在测试一下，http://${host}/value(256)?api-version=1.0应该就能正常匹配到ValueController了。

内容的提问来源于stack exchange，提问作者L.H.de