OData 8如何配置支持命名参数顺序无关的自定义路由？

这个问题我升级OData 8的时候也碰到过，核心原因是OData 8和ASP.NET Core路由系统绑定得更紧密了：原来.NET Framework里的[ODataRoute]是基于OData自身的解析逻辑，天然支持命名参数无序匹配；但换成[HttpGet]后，就会遵循ASP.NET Core路由的严格顺序匹配规则，参数顺序一变就会返回404。

给你几个可行的解决方案，按推荐程度排序：

1. 回归使用OData原生的[ODataRoute]属性 #

这是最省心的方案，毕竟OData本身就支持这种无序命名参数的函数调用语法，只需要调整回原来的属性并确保OData配置正确：

首先，把Action上的[HttpGet]替换回[ODataRoute]：

[ODataRoute("/myEndpoint(FirstName={firstName},LastName={lastName})/Data")]
public IActionResult GetData(string firstName, string lastName)
{
    // 你的业务逻辑
}

然后在Program.cs里正确配置OData的Edm模型，需要把这个自定义的myEndpoint注册为一个OData函数：

builder.Services.AddControllers()
    .AddOData(options => options
        .Select()
        .Filter()
        .OrderBy()
        .Expand()
        .SetMaxTop(100)
        .AddRouteComponents("odata", GetEdmModel()));

// 定义Edm模型的方法
private static IEdmModel GetEdmModel()
{
    var modelBuilder = new ODataConventionModelBuilder();
    
    // 注册名为myEndpoint的函数，指定返回类型（根据你的实际情况调整）
    var myFunction = modelBuilder.Function("myEndpoint")
        .ReturnsCollection<YourDataDto>(); // 如果是返回实体集，用ReturnsCollectionFromEntitySet
    
    // 添加函数需要的参数
    myFunction.Parameter<string>("FirstName");
    myFunction.Parameter<string>("LastName");
    
    return modelBuilder.GetEdmModel();
}

这样配置后，OData会自动处理路由参数的解析，不管参数顺序如何，都能正确匹配到你的Action，和之前.NET Framework里的行为完全一致。

2. 自定义路由约束（适合必须用[HttpGet]的场景） #

如果因为某些原因不能用[ODataRoute]，可以自定义一个路由约束来忽略参数顺序：

首先创建一个实现IRouteConstraint的约束类：

public class ODataParamOrderInsensitiveConstraint : IRouteConstraint
{
    public bool Match(HttpContext httpContext, IRouter route, string routeKey, RouteValueDictionary values, RouteDirection routeDirection)
    {
        var requestPath = httpContext.Request.Path.Value;
        // 定位路由中的参数部分（括号内的内容）
        var paramStartIndex = requestPath.IndexOf('(');
        var paramEndIndex = requestPath.IndexOf(')');
        
        if (paramStartIndex == -1 || paramEndIndex == -1)
            return false;
            
        var paramSegment = requestPath.Substring(paramStartIndex + 1, paramEndIndex - paramStartIndex - 1);
        // 解析参数为键值对（这里简单处理，若参数值含逗号/等号需要更复杂的正则解析）
        var paramDict = paramSegment.Split(',')
            .Select(pair => pair.Split('='))
            .ToDictionary(kv => kv[0].Trim(), kv => kv[1].Trim(), StringComparer.OrdinalIgnoreCase);
            
        // 检查必填参数是否都存在
        var requiredParams = new[] { "FirstName", "LastName" };
        foreach (var param in requiredParams)
        {
            if (!paramDict.ContainsKey(param))
                return false;
                
            // 将参数值存入RouteValueDictionary，供Action获取
            values[param.ToLower()] = paramDict[param];
        }
        
        return true;
    }
}

然后在Program.cs里注册这个约束：

builder.Services.Configure<RouteOptions>(options =>
{
    options.ConstraintMap.Add("odataParams", typeof(ODataParamOrderInsensitiveConstraint));
});

最后修改你的Action路由：

[HttpGet("/myEndpoint({*odataParams:odataParams})/Data")]
public IActionResult GetData(string firstName, string lastName)
{
    // 业务逻辑
}

这种方式需要自己处理参数解析的细节，比如参数值包含特殊字符的情况，不如OData原生方案可靠，但能满足必须用[HttpGet]的场景。

3. 中间件重写URL（应急方案） #

如果上面两种都不适用，可以用中间件拦截请求，把参数顺序调整成路由定义的顺序，再转发请求：

app.Use(async (context, next) =>
{
    var path = context.Request.Path.Value;
    // 匹配特定的路由模式
    if (path.StartsWith("/odata/myEndpoint(", StringComparison.OrdinalIgnoreCase) && path.EndsWith("/Data"))
    {
        var paramStart = path.IndexOf('(');
        var paramEnd = path.IndexOf(')');
        if (paramStart != -1 && paramEnd != -1)
        {
            var paramSegment = path.Substring(paramStart + 1, paramEnd - paramStart - 1);
            var paramDict = paramSegment.Split(',')
                .Select(pair => pair.Split('='))
                .ToDictionary(kv => kv[0].Trim(), kv => kv[1].Trim(), StringComparer.OrdinalIgnoreCase);
                
            // 按路由定义的顺序重新构建参数串
            var newParamSegment = $"FirstName={paramDict["FirstName"]},LastName={paramDict["LastName"]}";
            var newPath = path.Substring(0, paramStart + 1) + newParamSegment + path.Substring(paramEnd);
            
            // 重写请求路径
            context.Request.Path = newPath;
        }
    }
    
    await next();
});

这个方案比较直接，但同样需要处理参数值的特殊字符问题，适合临时应急使用。

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