MVC属性路由携带query参数失效 如何兼容原有查询参数URL格式

解决方案 #

你可以通过以下几种方式实现路由兼容，无需修改现有请求签名：

方案1：同时兼容路径参数、查询参数两种格式

WebAPI原生支持为同一个Action绑定多个路由特性，直接添加两个路由规则即可：

[HttpGet]
[Route("api/v1/business")] // 适配查询参数格式 /business?id=101
[Route("api/v1/business/{id:int}")] // 兼容原有路径参数格式 /business/101
public IHttpActionResult Get([FromUri]int? id)
{
    // 原有业务逻辑无需修改
}

该方案下两种请求格式都能正常命中接口，路径参数的优先级高于查询参数，符合默认参数绑定规则。

方案2：仅支持查询参数格式

如果不需要兼容路径参数的访问方式，直接移除路由模板中的路径参数定义即可：

[HttpGet, Route("api/v1/business")]
public IHttpActionResult Get([FromUri]int? id)
{
    // 原有业务逻辑无需修改
}

此时接口会自动从查询字符串中读取id参数，完全匹配你要求的http://localhost:64182/api/v1/business?id=101格式。

补充说明 #

1. 你提到的"添加问号标记参数可选不被允许"是写法错误，正确的可选路径参数写法是将问号放在大括号内部的类型约束之后，如下所示，单路由即可实现两种格式兼容：

[HttpGet, Route("api/v1/business/{id:int?}")]
public IHttpActionResult Get([FromUri]int? id)

2. 请检查WebApiConfig.cs的配置顺序，确保属性路由开启在全局默认路由之前，即可解决你遇到的"找不到名为api的控制器"错误：

public static class WebApiConfig
{
    public static void Register(HttpConfiguration config)
    {
        // 优先开启属性路由
        config.MapHttpAttributeRoutes();
        
        // 全局默认路由放在后面，避免拦截属性路由请求
        config.Routes.MapHttpRoute(
            name: "DefaultApi",
            routeTemplate: "api/{controller}/{id}",
            defaults: new { id = RouteParameter.Optional }
        );
    }
}

内容的提问来源于stack exchange，提问作者Donald N. Mafa