Spring Boot 中解决 PUT 和 DELETE 请求失效的方法

实现原理与核心步骤

要实现非 POST 请求，核心逻辑是让前端提交一个标准的 POST 请求，同时在请求体中携带一个特殊参数来标识真实的意图。后端接收到 POST 请求后，通过配置好的过滤器解析该参数，从而将当前的 HTTP 请求类型转换为对应的 PUT 或 DELETE 类型。

第1步：检查并开启 HiddenHttpMethodFilter

在传统的 Spring MVC 项目中，开发者需要在 web.xml 中手动注册 org.springframework.web.filter.HiddenHttpMethodFilter 过滤器，并映射到所有 URL（/*）。而在 Spring Boot 中，该组件已被纳入自动配置类中，因此通常不需要编写 Java Config，但需要注意开关状态。

在新版 Spring Boot（2.x 及后续版本）中，出于精简考虑，HiddenHttpMethodFilter 的自动配置默认是关闭的。如果未开启配置，即使前端代码写对了，后端也无法识别 PUT 或 DELETE 请求，导致 Controller 中对应注解的方法不被匹配。

解决办法是在项目的配置文件中显式开启该过滤器：

# application.properties
spring.mvc.hiddenmethod.filter.enabled=true

第2步：构建包含隐藏域的 HTML Form

在 Thymeleaf 模板或其他前端页面中，创建 method 为 post 的表单。关键在于添加一个名称为 _method 的隐藏输入框（Hidden Input），其 value 属性设置为目标的 HTTP 动词（如 put 或 delete）。

以更新员工信息为例，当存在 employee 对象时使用 PUT 方式：

<form th:action="@{/emp/{id}(id=${employee.id})}" method="post">
    <input type="hidden" name="_method" value="put" />
    <!-- 其他表单项 -->
    <button type="submit">保存修改</button>
</form>

以删除操作为例，同样使用 POST 表单包裹 DELETE 标记：

<form th:action="@{/emp/{id}(id=${emp.id})}" method="post">
    <input type="hidden" name="_method" value="delete" />
    <button type="submit" class="btn btn-sm btn-danger"> 删除 </button>
</form>

高级自定义（可选）

默认的隐藏域参数名为 _method，如果你的业务场景不希望使用该字段名，可以通过定义一个 Bean 来自定义该参数名称。例如将其修改为 _m：

@Bean
public HiddenHttpMethodFilter hiddenHttpMethodFilter() {
    HiddenHttpMethodFilter methodFilter = new HiddenHttpMethodFilter();
    methodFilter.setMethodParam("_m"); // 将隐藏域 _method 改为 _m
    return methodFilter;
}

完成上述 Bean 配置后，前端表单中的隐藏域名称也需同步改为 name="_m"。

总结

Spring Boot 中模拟 PUT 和 DELETE 请求并非直接发送这两种请求，而是通过“POST + 隐藏域”的方式，由服务端拦截器进行转换。务必注意在配置文件中进行 spring.mvc.hiddenmethod.filter.enabled=true 的设置，这是新版 Spring Boot 中容易踩坑的关键点。

以上就是Spring Boot中解决PUT和DELETE请求无法使用的详细内容，更多关于Spring Boot HTTP请求配置的资料请关注本站其它相关文章！