SpringBoot+Thymeleaf表单验证：错误信息无法显示问题

针对表单提交后后台检测到错误但前端不显示的问题，可按以下步骤排查修复：

1. 修正POST方法中@ModelAttribute的名称绑定 #

你的表单通过th:object="${data}"绑定到名为data的模型属性，但POST方法中的@ModelAttribute未指定名称，默认会使用类名首字母小写（natalChartDataPayload），导致错误信息与表单绑定的模型属性不匹配。

修改POST方法，显式指定@ModelAttribute的名称为data，同时重新添加页面所需的months数据：

@PostMapping("/create")
public String createNatalChart(
    @Valid @ModelAttribute("data") NatalChartDataPayload data,
    BindingResult result,
    Model model
) {
    if (result.hasErrors()) {
        model.addAttribute("months", Month.values()); // 重新注入页面依赖的月份数据
        return "natalChartData";
    }
    // 后续业务逻辑
}

2. 确保实体类验证注解配置正确 #

检查NatalChartDataPayload的email字段是否添加了正确的JSR-380验证注解，比如：

public class NatalChartDataPayload {
    @NotBlank(message = "邮箱不能为空")
    @Email(message = "邮箱格式不符合要求")
    private String email;
    
    // 其他字段、getter/setter、Builder相关代码
}

3. 确认Thymeleaf模板中字段绑定与错误提示的对应关系 #

确保表单的输入字段与验证字段正确绑定，错误提示的表达式基于th:object生效：

<input type="email" th:field="*{email}" class="form-control" placeholder="请输入邮箱" />
<div th:if="${#fields.hasErrors('email')}" th:errors="*{email}" class="text-danger">Email Error</div>

核心原因说明 #

Spring Validation的错误信息会与@ModelAttribute指定的模型属性名称绑定，当名称不匹配时，Thymeleaf无法通过*{email}找到对应的错误信息；同时POST请求返回页面时，需要重新注入GET请求中添加的页面依赖数据（如months），避免页面渲染异常。

内容的提问来源于stack exchange，提问作者Nunyet Calçada