.NET Core Areas属性路由值传递异常，ASP.NET标签助手生成链接格式错误

问题根源 #

ASP.NET Core 标签助手生成路由链接时，会优先匹配路由模板中定义的占位参数，如果匹配到和参数名一致的占位符，就会将参数值填充到URL路径段中，未匹配到的参数才会转为查询字符串参数。你遇到的问题是因为当前生效的路由规则（区域全局路由或Action属性路由）中包含了{id}/{id?}占位符，所以id参数被填充到了路径尾部而非转为查询参数。

触发场景 #

• 全局区域路由配置带id占位符
  你在Program.cs（.NET 6+）或Startup.cs中注册的区域路由规则包含末尾的{id?}段：

  app.MapControllerRoute(
      name: "areas",
      pattern: "{area:exists}/{controller=Home}/{action=Index}/{id?}");
  

• Action属性路由带id占位符
  你的EditUserAction上标注的Route属性包含了{id}参数：

  [Area("Admin")]
  public class HomeController : Controller
  {
      // 路由模板带{id}，会优先匹配路径段参数
      [Route("[area]/[controller]/[action]/{id}")]
      public IActionResult EditUser(string id)
      {
          // 业务逻辑
      }
  }
  

解决方案 #

如果需要id参数以查询字符串形式传递，可任选以下一种方案：

1. 修改路由模板
   删掉对应路由规则中的{id?}/{id}占位符，比如将全局区域路由改为：

   app.MapControllerRoute(
       name: "areas",
       pattern: "{area:exists}/{controller=Home}/{action=Index}");
   

   或者修改属性路由模板为[Route("[area]/[controller]/[action]")]。
2. 明确指定参数来源为查询字符串
   不需要修改路由规则，直接给Action的id参数添加[FromQuery]特性，框架会自动识别参数来源，标签助手也会对应生成查询字符串格式的链接：

   public IActionResult EditUser([FromQuery] string id)
   {
       // 业务逻辑
   }
   

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