在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模板):
<!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>用户注册</title> <link rel="stylesheet" th:href="@{/styles.css}"> </head> <body> <form th:action="@{/user}" th:Object="${testuser}" method="post"> <div th:if="${#fields.hasErrors('*')}"> <ul> <li th:each="err : ${#fields.errors('*')}" th:text="${err}"></li> </ul> </div> <label for="name">用户名:</label> <input type="text" id="name" th:field="*{name}" /><br/> <label for="email">邮箱:</label> <input type="email" id="email" th:field="*{email}" /><br/> <label for="password">密码:</label> <input type="password" id="password" th:field="*{password}" /><br/> <button type="submit">注册</button> </form> </body> </html>
问题根源及解决方案:
原代码中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属性名的一致性至关重要。
