Razor Page中Post请求触发失败：OnPost方法未执行

问题描述 #

我正在使用Razor Page进行开发，编写了如下表单代码：

<form method="post" >
    <input type="text" style="display:none;" name="Id" 
           value="@Model.Employee.ID" />
    <div class="form-group">
        <label for="name">Name</label>
        <input type="text" class="form-control" value="@Model.Employee.FirstName" 
               name="name" id="name" placeholder="Enter Name">
    </div>
    <br />
    <div class="form-group">
        <label for="email">Email address</label>
        <input type="email" class="form-control" value="@Model.Employee.Email" 
               name="email" id="email" aria-describedby="emailHelp" 
               placeholder="Enter email">
    </div>
    <br />
    <div class="form-group">
        <label for="email">Mobile</label>
        <input type="text" class="form-control" value="@Model.Employee.Mobile" 
               name="mobile" id="mobile" aria-describedby="emailHelp" 
               placeholder="Enter email">
    </div>
    <br />

    <button type="submit" class="btn btn-primary">A</button>
</form>

以及对应的后端OnPost方法代码：

public void OnPost()
{
    var emp = new DTO.Employee();
    emp.EmployeeId = Request.Form["Id"].ToString();
    emp.FirstName = "";
    emp.LastName = "";
    emp.MotherName = "";
    emp.SecondName = "";
    emp.MaterialStatus = "";
    emp.Gender = "";
    emp.ForeignFirstName = "";
    emp.ForeignLastName = "";
    emp.ForeignSecondNamee = "";
    emp.ForeignThirdNamee = "";
    emp.IsDeleted = true;
    emp.Nationality = "";
    emp.NoBrothersAllowed = false;
    emp.ThirdName = "";
    emp.Phone = "";
    emp.PassportNumber = "";
    emp.Mobile = Request.Form["mobile"].ToString();
    emp.Email = Request.Form["Email"].ToString();
    emp.FirstName = Request.Form["name"].ToString();
    //emp.ID = int.Parse(Request.Form["Id"].ToString());
    EmployeeService.Update(emp);
    Response.Redirect("Index1");
}

但提交表单时，public void OnPost()方法并未触发，请问可能是什么原因？

排查与解决要点 #

1. 缺少防伪验证令牌（最常见原因） #

Razor Pages默认强制启用防伪验证机制，用于防范跨站请求伪造攻击。如果表单中未包含防伪令牌，ASP.NET Core会直接拦截POST请求，导致OnPost方法无法执行。

解决办法：
在表单内添加防伪令牌，二选一即可：

• 使用HTML辅助方法：

  @Html.AntiForgeryToken()
  

• 给<form>标签添加asp-antiforgery="true"属性：

  <form method="post" asp-antiforgery="true">
  

2. 表单提交路径错误 #

虽然Razor Pages表单默认提交到当前页面，但如果页面有自定义路由配置，或者表单action属性被错误设置，会导致请求发送到错误端点，无法触发目标页面的OnPost方法。

解决办法：
显式指定表单提交的目标页面，使用asp-page标签助手（替换为你的页面名称）：

<form method="post" asp-page="./YourPageName">

3. 前端JS阻止了表单默认提交行为 #

如果页面中存在自定义JavaScript代码，比如给提交按钮或表单绑定了preventDefault()方法，会阻止表单的默认POST请求发送，导致后端方法无法触发。

解决办法：
检查页面中的所有JavaScript代码，确认没有拦截表单提交的逻辑；可临时移除所有自定义JS，测试是否能正常提交。

4. 请求被中间件拦截 #

如果项目中配置了权限验证、自定义日志等中间件，可能会拦截未通过验证的POST请求，导致OnPost方法无法执行。

解决办法：

• 检查中间件配置顺序，确保Razor Pages相关中间件（app.MapRazorPages()）在自定义中间件之后；
• 确认当前请求用户具有访问该页面POST端点的权限。

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