ASP.NET路由报错：命名参数需置于固定参数后，本地正常但CI构建失败如何修复

报错核心本质 #

提示“命名参数规范必须在所有已指定的固定参数之后出现”是C#编译器层面的语法解析错误，和ASP.NET MVC路由的运行时逻辑无关，出现本地正常、CI部署失败的差异，本质是两边的编译环境规则不匹配，不是路由规则本身的逻辑错误。

分步修复操作 #

• 先定位编译报错的真实触发点
  不要直接修改路由业务逻辑，先拉取CI编译流水线的完整日志，找到抛语法错的具体代码行。本地用新版Roslyn编译器时，对方法重载的命名参数匹配容错率很高；但CI环境如果用了旧版本编译器/旧版.NET SDK，遇到混写位置参数、命名参数的方法调用时，不会自动匹配对应重载，会强制校验参数顺序，哪怕本地能正常编译，CI端也会直接抛语法错误。
• 统一MapRoute调用的传参写法
  现有路由注册代码存在位置参数、命名参数混写的问题，旧编译器很容易出现参数识别歧义。调整为全命名参数的显式写法，消除识别歧义：

  routes.MapRoute(
      name: "Landing",
      url: "{action}/",
      defaults: new { controller = "Landing", action = "Home" }
  );
  
  routes.MapRoute(
      name: "Default",
      url: "{controller}/{action}/{id}",
      defaults: new { controller = "User", action = "Login", id = UrlParameter.Optional }
  );
  

  原写法中Landing路由的第三个参数没有显式标注参数名，旧编译器可能把它错识别为constraints参数，进一步触发参数顺序校验错误。
• 对齐两边编译环境的版本
  本地开发环境通常安装的是最新版.NET Framework SDK、最新版Roslyn编译器，对语法解析的容错范围更广；如果CI流水线使用的MSBuild、SDK版本和本地不一致，就会出现本地无法复现的编译错误。需要把CI构建用的SDK、编译器版本和本地开发环境完全对齐，同时可以在项目配置文件中显式锁定C#语言版本，避免不同环境的编译规则漂移。
• 顺带校验路由匹配的潜在逻辑问题
  当前配置中Landing路由的{action}/匹配规则优先级高于Default路由，会拦截所有无Controller段的请求，部署完成后需要额外验证路由匹配是否符合预期，避免出现部署后路由跳错的次生问题。

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