在spring boot應(yīng)用中，使用@Valid注解和Errors對象進行表單驗證時，有時Controller層已捕獲錯誤，但頁面卻無法顯示這些錯誤信息。本文分析一個實際案例，講解如何解決thymeleaf模板中表單驗證錯誤信息渲染失敗的問題。
問題描述: 使用Spring Boot和Thymeleaf構(gòu)建表單，應(yīng)用@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"; } // ... 保存用戶數(shù)據(jù) ... 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添加的對象名大小寫不一致，導(dǎo)致Thymeleaf找不到正確的對象，無法顯示錯誤信息。 解決方案: 確保th:object屬性與Controller中添加的Model屬性名完全一致（大小寫敏感）。 另外，使用了BindingResult bindingResult代替Errors errors，這是Spring更推薦的方式。 并且在模板中，用th:if=”${#fields.hasErrors(‘*’)}”和th:each循環(huán)遍歷所有錯誤信息，而不是單獨處理每個字段的錯誤。 在showRegisterForm方法中，直接在model中添加testuser對象，避免了潛在的沖突。
通過以上修改，Thymeleaf模板能夠正確渲染表單驗證錯誤信息。 記住，在Spring mvc中，保持模型屬性名與Thymeleaf模板中th:object屬性名的一致性至關(guān)重要。
