Thymeleaf的th:if与th:errors无法显示BindingResult中的错误

一、解决Thymeleaf无法识别BindingResult错误的问题 #

• 字段名必须严格匹配：自定义Validator中调用bindingResult.rejectValue("xxx", ...)时的字段名，要和页面表单字段的th:field（或name属性）完全一致，大小写也不能错。比如Validator报错字段是email，页面input必须是th:field="*{email}"或name="email"，否则Thymeleaf的#fields无法匹配到错误。
• BindingResult参数位置不能错：Controller中BindingResult必须紧跟在要校验的模型对象参数后面，比如：

  // 正确写法
  public String saveUser(@ModelAttribute("user") User user, BindingResult bindingResult) {
      // 校验逻辑
  }
  

  如果中间插入了其他参数（比如HttpServletRequest），Spring不会把校验错误绑定到这个BindingResult实例，导致页面拿不到错误。
• Validator调用/注册要正确：
  • 手动调用Validator时，必须传入Controller参数里的BindingResult，不能自己new一个新的：

    customValidator.validate(user, bindingResult); // 正确
    // 错误：new BindingResult()会导致错误不被Spring管理
    

  • 通过@InitBinder注册Validator时，要指定对应的模型名称，确保只应用到目标对象：

    @InitBinder("user") // 这里的"user"要和@ModelAttribute的名称一致
    public void initUserBinder(WebDataBinder binder) {
        binder.setValidator(customUserValidator);
    }
    

• 页面form必须绑定模型对象：表单标签要加上th:object="${模型对象}"，比如<form th:object="${user}" method="post">，Thymeleaf的#fields依赖这个对象来关联字段错误。

二、解决IllegalStateException: Invalid target for Validator异常 #

• 检查Validator的supports()方法：确保该方法正确返回目标类的匹配结果，比如校验User对象的Validator：

  @Override
  public boolean supports(Class<?> clazz) {
      return User.class.isAssignableFrom(clazz); // 正确
      // 错误示例：返回了其他类或错误的判断逻辑
  }
  

  如果supports()返回false，Spring调用Validator时就会抛出目标无效的异常。
• 避免Validator全局注册：如果@InitBinder没有指定模型名称，该Validator会被应用到所有模型对象，当处理其他类型的对象时就会触发异常。所以一定要给@InitBinder指定对应的模型名称，或者在supports()里做严格的类型判断。
• 手动调用时校验对象类型：如果是手动调用Validator，要确保传入的对象是该Validator支持的类型，不要传入错误的实例。

调试技巧 #

• 在Controller里打印bindingResult.getFieldErrors()，确认每个错误的field属性和页面字段是否匹配。
• 页面上可以直接输出${bindingResult.fieldErrors}，如果能看到错误列表，说明是Thymeleaf的#fields匹配问题，否则是错误没有正确绑定到BindingResult。

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