Spring框架中BindingResult.hasErrors验证失效问题排查

问题概述 #

使用Spring框架开发时，已将Cliente实体映射至控制器，通过@NotEmpty等注解实现字段验证逻辑，搭配@Valid注解与BindingResult.hasErrors()方法，但提交空字段时hasErrors()始终返回false，验证未生效。

问题原因及解决方案 #

1. 实体类缺少无参构造函数 #

Spring MVC表单数据绑定依赖无参构造函数实例化实体对象，当前Cliente仅提供带参构造，导致对象无法正常初始化，验证注解无法触发。

解决：添加无参构造函数

@Entity
@Table(name = "Clientes")
public class Cliente {
    // 原有字段定义...

    // 添加无参构造函数
    public Cliente() {}

    // 原有带参构造函数...
    // 原有getter/setter方法...
}

2. 控制器参数顺序与注解冗余 #

• BindingResult必须紧跟在被@Valid标记的实体参数之后，否则Spring无法将验证错误绑定到BindingResult实例中。
• 控制器类上的@Validated用于分组验证，若无分组需求可移除，避免干扰基础验证逻辑。

修正后的控制器代码

@Controller
public class FormController {

    @Autowired
    ClienteServices service; 

    @GetMapping("/register")
    public String formLoggin(Model model) {
        model.addAttribute("Title", "Registro");
        // 手动实例化对象，确保表单绑定正常
        model.addAttribute("cliente", new Cliente());
        return "register";
    }   

    @PostMapping("/register")
    // BindingResult必须紧跟@Valid标记的参数
    public String sendForm(@Valid Cliente cliente, BindingResult result, Model model) {   
        model.addAttribute("data", "Registro");
        
        if(result.hasErrors()){
            return "register";
        }
        model.addAttribute("cliente", cliente);
        return "dataUser";
    }
}

3. 验证依赖缺失 #

若使用Spring Boot，需确保spring-boot-starter-validation依赖已引入，否则@NotEmpty等验证注解不会生效。

Maven依赖示例

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

4. 前端表单优化 #

th:field会自动生成正确的name属性，手动指定的name可能与生成属性冲突，建议移除手动添加的name属性：

修正后的前端表单片段

<input id="username" type="text" th:field="*{primerNombre}">
<input id="Secondname" type="text" th:field="*{segundoNombre}">
<!-- 其他输入框同理 -->

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