SpringBoot3环境下Controller无法接收HTML表单数据的原因排查

结合你的技术栈与代码，以下是核心排查方向及解决方法：

1. Spring Security未放行注册提交的POST请求 #

你的SecurityConfig仅对/sign-up的GET请求开放匿名访问，但POST请求的/sign-up/save未被加入放行列表，导致Spring Security会拦截该请求（规则为anyRequest().authenticated()），请求根本无法到达Controller。

修复方法： #

在authorizeHttpRequests中新增对POST方法/sign-up/save的放行：

.authorizeHttpRequests((auth) -> auth
    .requestMatchers(PathRequest.toStaticResources().atCommonLocations()).permitAll()
    .requestMatchers(HttpMethod.GET,
            "/",
            "/articles",
            "/articles/search-hashtag",
            "/sign-up").permitAll()
    // 新增：放行注册提交的POST请求
    .requestMatchers(HttpMethod.POST, "/sign-up/save").permitAll()
    .anyRequest().authenticated()
)

2. HTML表单字段name与DTO字段不匹配 #

使用@ModelAttribute绑定参数时，表单元素的name属性必须与UserAccountDto的字段名完全一致：

• DTO字段：userId、userPassword、email、nickname、memo
• 表单需对应写成：

  <input type="text" name="userId" />
  <input type="password" name="userPassword" />
  <input type="email" name="email" />
  <!-- 其他字段同理 -->
  

若表单中误写为username（与登录表单混淆），会直接导致userId等字段无法绑定。

3. @ModelAttribute前缀配置冲突 #

你使用了@ModelAttribute("user")，若表单字段未添加user.前缀，可能出现绑定失败。可二选一调整：

• 去掉@ModelAttribute的value，直接写@ModelAttribute UserAccountDto user
• 或在表单字段前添加前缀：name="user.userId"

4. 表单提交基础配置错误 #

确保HTML表单的核心配置正确：

<form method="post" action="/sign-up/save" enctype="application/x-www-form-urlencoded">
  <!-- 表单元素 -->
</form>

• method必须为post，与Controller的@PostMapping对应
• 无文件上传时，enctype使用默认的application/x-www-form-urlencoded即可

5. Record类型参数绑定的冗余字段影响 #

虽然Spring Boot 3支持将Record用作@ModelAttribute参数，但DTO中包含的createdAt、createdBy等无需前端传递的字段，可能增加绑定复杂度。建议拆分出仅用于注册的精简DTO，比如：

public record RegisterUserDto(
        String userId,
        String userPassword,
        String email,
        String nickname,
        String memo
) {}

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