Spring Boot表单POST请求返回404错误排查求助

以下是针对该问题的核心排查方向：

1. 表单提交路径不匹配 #

• 核对Controller中@PostMapping的路径与Thymeleaf表单th:action的实际渲染结果：
  • 查看浏览器渲染后的HTML，确认表单action属性的最终值，是否与HTTPie请求的URL完全一致（注意斜杠、大小写、上下文路径）。
  • 如果使用相对路径，比如表单写action="add"，而当前页面URL是/items，实际提交路径会是/items/add，若Controller映射的是/add则会触发404。建议用Thymeleaf的@{/add}语法自动处理上下文路径与路径拼接。

2. CSRF令牌缺失或无效 #

• Spring Boot默认启用CSRF保护，POST请求需携带CSRF令牌：
  • 检查浏览器渲染后的HTML，是否包含<input type="hidden" name="_csrf" value="xxx"/>这类隐藏字段。如果没有，需确保表单使用Thymeleaf的th:form标签，或手动通过th:action结合_csrf参数生成。
  • HTTPie请求如果未携带CSRF令牌却成功，可能是你在配置中临时禁用了CSRF，或者Controller的路径被排除在CSRF校验外，这会导致表单提交因缺少令牌被拦截（部分场景下会返回404而非403，需结合日志确认）。

3. 请求方法不匹配 #

• 确认：
  • Controller方法使用的是@PostMapping而非@GetMapping或其他映射注解。
  • 表单的method属性渲染后为post，而非get或拼写错误（比如methord）。

4. 上下文路径配置影响 #

• 如果项目配置了server.servlet.context-path，表单提交路径必须包含该上下文路径。Thymeleaf的@{/xxx}语法会自动拼接上下文路径，避免硬写路径导致的错误。

辅助排查步骤 #

• 查看Spring Boot应用日志，重点关注404请求的完整URL、请求方法，对比HTTPie请求的日志记录，确认两者的路径差异。
• 直接在浏览器开发者工具中手动构造POST请求（携带正确CSRF令牌），验证路径是否可达。

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