SpringMVC中GetMapping正常但Thymeleaf表单POST无法映射Controller

GET请求可正常命中@GetMapping("/signup")方法，说明组件扫描、基础路径映射规则没有问题，POST请求无法响应优先排查以下高频原因，按出现概率从高到低排序：

• Spring Security CSRF防护拦截（90%以上同类问题的根因）
  Spring Security默认开启CSRF攻击防护，所有非GET、HEAD、TRACE的请求如果没有携带合法的CSRF令牌，会被安全过滤器直接拦截返回403，根本不会到达Controller层，自然不会执行你写在POST方法里的打印逻辑。
  两种修复方式选其一即可：
  1. （普通表单项目推荐）在表单内加入CSRF隐藏域，Thymeleaf会自动读取上下文里的CSRF令牌并渲染，不需要手动传值：

  <form method="POST" th:action="@{/signup}" th:object="${memberDto}">
      <!-- 新增下面这行隐藏域 -->
      <input type="hidden" th:name="${_csrf.parameterName}" th:value="${_csrf.token}" />
      <input type="submit" value="Sign up">
  </form>
  

  2. （仅适合无状态接口服务）如果项目不需要CSRF防护，可以在Spring Security配置类中关闭该功能：

  @Configuration
  public class SecurityConfig {
      @Bean
      public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
          http
              .csrf(csrf -> csrf.disable())
              // 其余原有权限配置保持不变
              .authorizeHttpRequests(auth -> auth
                  .requestMatchers("/signup").permitAll()
                  .anyRequest().authenticated()
              );
          return http.build();
      }
  }
  

• 自定义拦截器/过滤器未放行POST路径
  如果项目里写了自定义登录拦截器、权限过滤器，很可能只放行了GET类型的/signup路径，POST请求被拦截后直接跳转到登录页或者错误页。
  排查方式：打开浏览器开发者工具，查看提交表单后的POST请求响应状态码，如果是302跳转、响应码不是200，就检查拦截器、过滤器的路径匹配规则，把POST类型的/signup加入放行列表。
• 参数绑定阶段提前抛出异常
  如果MemberDto类没有提供公开的无参构造函数、或者表单内字段的name属性和MemberDto的属性名不匹配，Spring会在参数绑定阶段直接抛出400错误，不会进入方法内部执行逻辑。
  排查方式：查看服务端控制台的异常栈，如果有数据绑定、参数转换相关的报错，对应修复即可：给MemberDto加无参构造，保证表单字段名和Dto属性名一致。

额外优化建议：POST接口可以直接用@PostMapping("/signup")注解代替现在的@RequestMapping(value="/signup", method=RequestMethod.POST)，代码语义更清晰，不过这个写法本身不会导致映射失败。

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