Spring Boot表单验证错误信息无法显示在页面上是什么原因？

Spring Boot表单验证错误信息页面显示问题排查指南

在Spring Boot应用中，使用@Valid注解和Errors对象进行表单验证时，有时Controller层已捕获错误，但页面却无法显示这些错误信息。本文分析一个实际案例，讲解如何解决Thymeleaf模板中表单验证错误信息渲染失败的问题。

问题描述: 使用Spring Boot和Thymeleaf构建表单，应用@NotBlank和@Email注解进行验证。Controller层能正确获取错误信息，但Thymeleaf模板无法显示错误提示。

代码分析:

TestUser.java (表单实体类):

@Data
@Entity
@AllArgsConstructor
@NoArgsConstructor(access = AccessLevel.PUBLIC, force = true)
public class TestUser {
    @Id
    @NotBlank(message = "用户名必填")
    private String name;

    @Email(message = "邮箱格式错误")
    @NotBlank(message = "邮箱必填")
    private String email;

    @NotBlank(message = "密码必填")
    private String password;
}

TestUserController.java (Controller):

@Controller
@RequestMapping("/user")
public class TestUserController {

    @GetMapping
    public String showRegisterForm(Model model) {
        model.addAttribute("testuser", new TestUser()); // 直接在model中添加对象
        return "user";
    }

    @PostMapping
    public String register(@Valid TestUser testUser, BindingResult bindingResult) {
        if (bindingResult.hasErrors()) {
            return "user";
        }
        // ... 保存用户数据 ...
        return "redirect:/"
;
    }
}

user.html (Thymeleaf模板):

    
    
    


    

        
            

                

            
        
        用户名:
        

        邮箱:
        

        密码:
        

        注册
    

问题根源及解决方案:

原代码中Thymeleaf模板的th:object属性与Controller中Model添加的对象名大小写不一致，导致Thymeleaf找不到正确的对象，无法显示错误信息。 解决方案: 确保th:object属性与Controller中添加的Model属性名完全一致（大小写敏感）。 另外，使用了BindingResult bindingResult代替Errors errors，这是Spring更推荐的方式。 并且在模板中，用th:if="${#fields.hasErrors('*')}"和th:each循环遍历所有错误信息，而不是单独处理每个字段的错误。 在showRegisterForm方法中，直接在model中添加testuser对象，避免了潜在的冲突。

通过以上修改，Thymeleaf模板能够正确渲染表单验证错误信息。 记住，在Spring MVC中，保持模型属性名与Thymeleaf模板中th:object属性名的一致性至关重要。