Spring Boot+Thymeleaf表单验证始终报错问题求助

问题根源分析 #

从你提供的代码来看，导致无论输入是否符合规则都触发验证错误的核心原因主要有以下几点：

1. 实体类缺少属性Setter方法 #

Spring MVC绑定表单参数时，部分场景下依赖Setter方法完成属性注入。当前UserModel仅实现了getUsername()和getPassword()方法，没有对应的Setter，这可能导致表单提交的用户名和密码无法正确绑定到实体对象，进而触发@NotEmpty注解的验证失败。

修复代码：

// 为username和password添加Setter
public void setUsername(String username) {
    this.username = username;
}

public void setPassword(String password) {
    this.password = password;
}

// 建议同时为其他布尔字段添加Setter，避免后续问题
public void setAccountNonExpired(boolean accountNonExpired) {
    isAccountNonExpired = accountNonExpired;
}

public void setAccountNonLocked(boolean accountNonLocked) {
    isAccountNonLocked = accountNonLocked;
}

public void setCredentialsNonExpired(boolean credentialsNonExpired) {
    isCredentialsNonExpired = credentialsNonExpired;
}

public void setEnabled(boolean enabled) {
    isEnabled = enabled;
}

2. 布尔字段未初始化，默认值不符合预期 #

UserModel中的isAccountNonExpired、isAccountNonLocked等布尔字段默认值为false，虽然这些字段没有验证注解，但新注册用户的这些状态本应默认是true（启用、未锁定等）。未初始化的字段可能在Spring MVC绑定或后续JPA持久化环节触发隐性错误，间接导致验证流程异常。

修复代码：

public UserModel() {
    // 初始化新用户的默认状态
    this.isAccountNonExpired = true;
    this.isAccountNonLocked = true;
    this.isCredentialsNonExpired = true;
    this.isEnabled = true;
    this.authorities = new ArrayList<>();
}

3. 验证注解的错误信息笔误 #

password字段的@NotEmpty注解错误使用了"Username not be Empty!"的提示信息，虽然不影响验证逻辑，但会导致错误提示混淆，建议修正：

@NotEmpty(message = "Password cannot be empty!")
@Size(min = 6, max = 50)
private String password;

4. 调试验证错误细节（快速定位问题） #

如果以上修复后仍有问题，可以在Controller中打印所有验证错误的具体信息，明确触发错误的字段和原因：

@PostMapping("/register")
public String addUser(@Valid UserModel userModel, BindingResult result, Model model) {
    if (result.hasErrors()) {
        // 打印错误详情，便于精准排查
        result.getAllErrors().forEach(error -> {
            FieldError fieldError = (FieldError) error;
            System.out.println("错误字段：" + fieldError.getField());
            System.out.println("错误信息：" + error.getDefaultMessage());
        });
        return "register";
    }
    // 后续保存逻辑...
}

额外优化建议 #

• 可以引入Lombok的@Data注解，自动生成Getter、Setter、toString等方法，避免手动编写遗漏的问题。
• 确认Thymeleaf表单中的th:field属性与实体类字段名完全匹配（当前代码中的绑定是正确的，注意大小写敏感即可）。

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