ASP.NET Core 提交表单时Create Action未被Controller处理的问题解决

核心故障本质 #

当前故障为POST请求未匹配到Admin区域下CategoriesController的POST Create方法，请求在进入Action执行管线前就被拦截抛出异常，因此设置的调试断点无法触发。常见触发原因分为两类：

• 表单生成的提交地址缺失路由匹配参数
• 项目未正确注册区域路由规则

分步修复操作 #

• 修正表单标签的路由绑定
  原表单仅写了asp-action="Create"，未显式绑定所属路由上下文，在跨共享布局、路由约定不连续的场景下，会生成缺少/Admin前缀的错误提交地址。将原表单代码替换为显式指定全路由参数：

  <form asp-area="Admin" asp-controller="Categories" asp-action="Create" method="post">
  

  必须显式补全三个参数：

  • asp-area="Admin"：指定请求归属Admin区域，避免路由值自动丢失
  • asp-controller="Categories"：显式指定目标控制器，杜绝自动匹配错误
  • method="post"：明确请求方法，和Action上标注的[HttpPost]特性匹配

• 校验启动配置中的路由注册逻辑
  打开项目的启动配置文件（Program.cs 或 Startup.cs），确认区域路由的注册顺序在全局默认路由之前，正确的配置参考如下：

  // 注册Admin区域路由，必须放在全局路由注册之前
  app.MapAreaControllerRoute(
      name: "admin",
      areaName: "Admin",
      pattern: "Admin/{controller=Categories}/{action=Index}/{id?}");
  
  // 注册全局默认路由
  app.MapControllerRoute(
      name: "default",
      pattern: "{controller=Home}/{action=Index}/{id?}");
  

  最常见的配置疏漏是漏写MapAreaControllerRoute段，导致程序无法识别带/Admin前缀的请求归属。

• 校验防伪令牌的匹配逻辑
  当前POST Create方法上标注了[ValidateAntiForgeryToken]，该特性会在请求进入Action前校验表单携带的防伪令牌：

  • 修正表单代码后，可通过浏览器页面检查元素，确认form标签内部是否自动生成了__RequestVerificationToken隐藏字段
  • 如果字段缺失，直接在form标签内部手动添加防伪令牌生成代码：

    @Html.AntiForgeryToken()
    

  令牌校验失败同样会在进入Action前拦截请求，触发异常且不命中断点。

效果验证 #

改完代码后重新启动项目，进入Create页面点击提交时，先观察浏览器地址栏的请求地址，确认前缀为/Admin/Categories/Create，此时即可正常命中断点，进入编写的请求处理逻辑。

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