Spring Boot MVC Thymeleaf表单验证问题：@Valid与BindingResult无效始终无错误

使用Thymeleaf表单、Jakarta Validation的@Valid注解配合BindingResult做参数校验时，校验完全不起作用，BindingResult始终显示0个错误，排查文档、依赖等均无改善，以下是可行的解决方案：

• 检查依赖兼容性与完整性
  确保引入了Jakarta Validation的API和实现类，同时注意Spring Boot版本与Validation版本的匹配（Spring Boot 3.x对应Jakarta Validation 3.x）。Maven依赖示例：

  <dependency>
      <groupId>jakarta.validation</groupId>
      <artifactId>jakarta.validation-api</artifactId>
      <version>3.0.2</version>
  </dependency>
  <dependency>
      <groupId>org.hibernate.validator</groupId>
      <artifactId>hibernate-validator</artifactId>
      <version>8.0.1.Final</version>
  </dependency>
  <dependency>
      <groupId>org.hibernate.validator</groupId>
      <artifactId>hibernate-validator-annotation-processor</artifactId>
      <version>8.0.1.Final</version>
  </dependency>
  

• 严格遵循控制器参数顺序
  控制器方法中，@Valid必须标注在待校验的实体参数前，且BindingResult必须紧跟该实体参数，中间不能插入其他参数。正确示例：

  @PostMapping("/submit")
  public String submitForm(@Valid UserForm userForm, BindingResult bindingResult, Model model) {
      if (bindingResult.hasErrors()) {
          return "form";
      }
      // 执行业务逻辑
      return "success";
  }
  

  参数顺序错误会导致BindingResult无法捕获校验错误。

• 确认实体类校验注解的正确性
  实体类字段需使用jakarta.validation.constraints包下的注解（而非旧版javax.validation），且注解配置符合需求。示例：

  public class UserForm {
      @NotBlank(message = "用户名不能为空")
      private String username;
      
      @Email(message = "邮箱格式不合法")
      private String email;
      
      @Min(value = 18, message = "年龄不能小于18岁")
      private Integer age;
      
      // getter、setter方法
  }
  

• 保证Thymeleaf表单字段与实体类绑定正确
  表单输入框的name属性需与实体类字段名完全匹配，推荐使用th:field自动完成绑定和错误信息展示：

  <form th:action="@{/submit}" th:object="${userForm}" method="post">
      <div>
          <label>用户名：</label>
          <input type="text" th:field="*{username}"/>
          <span th:if="${#fields.hasErrors('username')}" th:errors="*{username}" class="error"></span>
      </div>
      <!-- 其他字段 -->
      <button type="submit">提交</button>
  </form>
  

• 校验功能是否开启
  Spring Boot默认自动开启校验，若手动配置了WebMvcConfigurer，确保未禁用校验；也可通过配置属性确认：

  spring.validation.enabled=true
  

内容的提问来源于stack exchange，提问作者Michał Sułek