Spring Boot表单验证信息无法显示在页面？如何排查Thymeleaf模板引擎错误？

spring boot表单验证信息无法在页面显示的排查

在使用Spring Boot进行表单验证时，我们常常利用@Valid注解和Errors对象来捕获验证错误。然而，有时即使在Controller层确认了错误信息的存在，前端页面却无法正确显示这些信息。本文将针对一个实际案例，分析此类问题产生的原因及解决方法。

问题描述：

开发者使用Spring Boot 2.7.10和Thymeleaf模板引擎构建了一个用户注册表单。通过@NotBlank和@Email注解对TestUser对象的字段进行验证。在Controller中，Errors对象成功捕获了验证错误，但这些错误信息却无法在Thymeleaf模板中显示。

代码分析：

TestUser.java定义了用户实体，包含了name、email和password字段，并使用了@NotBlank和@Email注解进行验证，这些注解包含了自定义的错误信息。

TestUserController.java的register方法使用了@Valid注解，并在errors对象中获取验证错误。然而，关键问题在于，页面渲染时没有正确地将错误信息传递给Thymeleaf模板。@ModelAttribute("testUser")方法用于创建TestUser对象，并将其添加到模型中。

user.html使用了Thymeleaf模板引擎来渲染表单。它尝试使用th:if="${#fields.hasErrors()}"和th:errors="*{name}"等表达式来显示错误信息。

问题原因及解决方法：

开发者在仔细排查后发现，问题在于模型中存在两个TestUser对象。Thymeleaf模板中使用的th:object="testuser"，而添加到模型中的对象名却是testUser (大小写差异)。由于名称不一致，模板引擎无法正确获取验证错误信息。

简单来说，Thymeleaf模板引擎根据th:object属性寻找模型中的对象，如果模型中对象名称与th:object指定的名称不一致（大小写敏感），则无法正确绑定对象及获取错误信息。 修改user.html中的th:object="testUser" (注意大小写)即可解决此问题。 正确地将模型中的对象名称与模板中的th:object属性保持一致是关键。

以上就是Spring Boot表单验证信息无法显示在页面？如何排查Thymeleaf模板引擎错误？的详细内容，更多请关注php中文网其它相关文章！