ASP.NET Core 2空参数路由配置：兼容旧VB项目链接

嗨，这个问题我之前迁移旧项目的时候也碰到过，核心是你现在的路由写法把查询字符串参数当成了路由的必填部分，所以只有所有参数都存在时才会匹配。其实有更简洁的方式来兼容旧链接的所有情况，下面给你两种可行的方案：

方案一：简化路由模板，利用自动查询参数绑定（推荐） #

在ASP.NET Core MVC中，查询字符串参数（?后面的键值对）根本不需要在路由模板里显式定义，框架会自动把它们绑定到Action方法的参数上，只要你做好参数映射即可。

步骤1：修改路由配置 #

把原来复杂的路由模板简化成只保留路径部分，去掉所有查询参数的定义：

routes.MapRoute(
    name: "Search",
    template: "t", // 只保留路径"/t"，查询参数交给框架自动处理
    defaults: new { controller = "Search", action = "Index" }
);

步骤2：配置Action参数的查询映射 #

在SearchController的Index方法中，用[FromQuery]特性把URL中的查询参数名（比如旧链接里的q、c）映射到方法参数上，同时给参数设置默认值或设为可空类型，确保参数缺失时也能正常调用：

public IActionResult Index(
    [FromQuery(Name = "q")] string keyword = null,
    [FromQuery(Name = "c")] string city = null,
    [FromQuery(Name = "z")] string zip = null,
    [FromQuery(Name = "p")] int page = 1, // 给page设置默认值1
    [FromQuery(Name = "dst")] string district = null,
    [FromQuery(Name = "sUrl")] string streetUrl = null,
    [FromQuery(Name = "cUrl")] string cityUrl = null
)
{
    // 这里处理你的业务逻辑，缺失的参数会自动使用默认值或null
    return View();
}

这样不管旧链接是/t?q=美食&c=北京，还是/t?p=3，甚至是只有/t，都能正常匹配到这个Action。

方案二：将路由模板中的参数标记为可选（不推荐，但兼容你的原有写法） #

如果你坚持要在路由模板里保留所有参数定义，可以给每个参数加上?标记为可选：

routes.MapRoute(
    name: "Search",
    template: "t/q={keyword?}&c={city?}&z={zip?}&p={page?}&dst={district?}&sUrl={streetUrl?}&cUrl={cityUrl?}",
    defaults: new { controller = "Search", action = "Index" }
);

不过这种写法会让路由模板非常冗长，而且本质上和方案一的效果一致，所以更推荐方案一的简洁写法。

额外提示：属性路由的写法 #

如果你习惯用属性路由（ASP.NET Core推荐的方式），可以直接在Action上标注路由，省去Startup里的路由配置：

public class SearchController : Controller
{
    [Route("t")]
    public IActionResult Index(
        [FromQuery(Name = "q")] string keyword = null,
        // 其他参数同上
    )
    {
        // 业务逻辑
        return View();
    }
}

这样配置后，所有旧链接的格式都能完美兼容，不管参数全不全都能正常访问啦～

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