ASP.NET Razor Pages自定义Post处理器未触发，仅执行OnGet

• 检查表单method属性
  必须给表单明确设置method="post"，Razor Pages默认走GET请求，没这个属性的话只会触发OnGet。示例：

  <form method="post">
    <!-- 表单内容 -->
  </form>
  

• 确认asp-page-handler属性配置
  自定义Post处理器（比如OnPostOrderInProcess）需要在提交按钮或表单上指定asp-page-handler="OrderInProcess"——注意handler名是方法名去掉OnPost后的部分。示例：

  <!-- 在按钮上设置 -->
  <button type="submit" asp-page-handler="OrderInProcess">标记为处理中</button>
  
  <!-- 或者在表单上设置 -->
  <form method="post" asp-page-handler="OrderInProcess">
    <!-- 表单内容 -->
  </form>
  

• 验证PageModel方法的正确性
  要保证自定义Post方法是public访问级别，返回类型为IActionResult或Task<IActionResult>（异步场景），命名格式严格遵循OnPost[HandlerName]或OnPostAsync[HandlerName]。示例：

  public IActionResult OnPostOrderInProcess()
  {
      // 业务逻辑代码
      return Page();
  }
  
  // 异步版本
  public async Task<IActionResult> OnPostOrderReadyAsync()
  {
      // 异步业务逻辑
      return Page();
  }
  

• 检查防伪造令牌是否存在
  Razor Pages默认拦截无防伪造令牌的POST请求，要么用form标签助手（自动生成令牌），要么手动添加@Html.AntiForgeryToken()到表单里。缺失令牌会导致请求被拦截，最终触发OnGet或直接报错。

• 排查路由与页面路径
  确认页面没有自定义路由覆盖默认规则，导致handler无法匹配；如果是跨页面提交，要检查表单的asp-page属性是否指向正确页面路径。

• AJAX提交的额外检查
  如果用AJAX提交，必须：

  • 把请求method设为POST
  • 请求头或数据中携带__RequestVerificationToken防伪造令牌
  • 传递handler参数，值对应处理器名称（比如handler=OrderCancel）

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