ASP.NET Core 3.1 MVC中HttpPut、HttpDelete实现与HTTP 405错误解决
405错误核心根因
根本原因是原生HTML表单仅支持GET、POST两种请求方法,所有主流浏览器都会自动把表单里写的PUT、DELETE这类非标准方法降级成POST发送。但你的控制器Action只绑定了[HttpPut]、[HttpDelete]特性,不匹配POST请求方法,自然会触发405(方法不允许)报错。
ASP.NET Core提供了内置的表单方法重写机制,专门用来兼容这种场景,不需要借助JavaScript就能实现PUT、DELETE请求的提交。
分步解决方案
- 第一步:给控制器补充双向路由绑定,兼容方法重写
现在的控制器路由配置存在两个问题:一是没有加载更新/删除视图对应的GET入口(从列表页点击进入更新/删除页面时走的是GET请求);二是硬编码只接收PUT/DELETE方法,不接收带方法重写标记的POST请求。
修正后的控制器代码参考:// 加载更新视图的GET入口 [HttpGet] [Route("Hr/ModifyEmployee/{employeeId}")] public IActionResult ModifyEmployee(int employeeId) { var employee = _hrService.EmployeeSystem.GetEmployeeById(employeeId); return View(employee); } // 处理更新提交的逻辑,同时绑定PUT和POST方法 [HttpPut] [HttpPost] [Route("Hr/ModifyEmployee/{employeeId}")] [ActionName("ModifyEmployee")] public IActionResult ModifyEmployee(int employeeId, Malips.Data.Employee employee) { if (ModelState.IsValid) { Malips.Data.Employee employeeDetail = _hrService.EmployeeSystem.UpdateEmployee(employee); return View("GetEmployee", employeeDetail); } // 校验失败时把原模型传回视图,避免页面空数据 return View(employee); } // 加载删除视图的GET入口 [HttpGet] [Route("Hr/DeleteEmployee/{employeeId}")] public IActionResult DeleteEmployee(int employeeId) { var employee = _hrService.EmployeeSystem.GetEmployeeById(employeeId); return View(employee); } // 处理删除提交的逻辑,同时绑定DELETE和POST方法 [HttpDelete] [HttpPost] [Route("Hr/DeleteEmployee/{employeeId}")] public IActionResult DeleteEmployeeConfirm(int employeeId) { _hrService.EmployeeSystem.DeleteEmployee(employeeId); return View("Index"); } - 第二步:给视图表单加上方法模拟标记
在原有表单标签的基础上,加上Tag Helper自带的asp-method属性,指定需要模拟的HTTP方法,这个属性会自动在表单内部生成隐藏的X-HTTP-Method-Override字段,供ASP.NET Core识别并重写请求方法。
更新视图的表单调整为:
删除视图的表单调整为:<form asp-controller="Hr" asp-action="ModifyEmployee" asp-route-employeeId="@Model.EmpId" asp-method="Put"> <!-- 原有表单内部的所有内容保持不变即可 --> </form><form asp-controller="Hr" asp-action="DeleteEmployee" asp-route-employeeId="@Model.EmpId" asp-method="Delete"> <!-- 原有表单内部的所有内容保持不变即可 --> </form> - 第三步:确认方法重写机制没有被禁用
打开Startup.cs的服务配置部分,检查AddControllersWithViews的配置项,默认情况下方法重写是全局开启的,如果被手动修改过,需要恢复默认状态:public void ConfigureServices(IServiceCollection services) { services.AddControllersWithViews(options => { // 不要把FormOptions里的SuppressInputFormFromMethodOverride设为true // 否则即使加了asp-method属性,重写机制也不会生效 }); }
常见踩坑提醒
- 不要直接在原生form标签上写
method="put"或者method="delete",所有浏览器都会自动把这类值降级为POST,根本不会发送对应的HTTP方法。 - 如果只补了提交的PUT/DELETE路由,忘了加GET入口,从列表页点进更新/删除视图时同样会报405,因为加载视图的请求是GET方法。
- 方法重写仅对POST表单请求生效,GET请求携带的方法重写字段会被直接忽略。
内容的提问来源于stack exchange,提问作者Joseph Nannepaga
相关产品推荐
相关产品推荐

