Spring验证消息显示差异原因：@ModelAttribute的作用

核心矛盾：模型属性名称不匹配 #

当你在POST方法中仅使用@Valid LoginDetails loginDetails时，Spring MVC会自动为该模型属性生成默认名称：将类名首字母转为小写，也就是loginDetails（注意类名是LoginDetails，默认名称保留了大写的D）。

而你的代码里：

• Thymeleaf模板中表单绑定的是th:object="${logindetails}"（全小写的d）；
• GET方法里也是通过model.addAttribute("logindetails", new LoginDetails());把模型属性存入logindetails这个名称下。

这就导致验证错误信息被绑定在默认名称loginDetails对应的模型属性上，但模板却在查找logindetails的错误信息，两者名称不匹配，自然无法渲染错误提示。

为什么添加@ModelAttribute("logindetails")就能正常显示？ #

当你显式添加@ModelAttribute("logindetails")注解时，相当于强制指定了该模型属性的名称为logindetails，和模板中th:object="${logindetails}"、GET方法中存入的模型名称完全一致。此时验证错误会被正确绑定到logindetails属性上，Thymeleaf就能通过#fields.hasErrors('userName')找到对应的错误信息并展示。

关键细节：BindingResult的关联规则 #

需要注意，BindingResult参数必须紧跟在被@Valid注解的参数后面，这是Spring MVC的规则——它会把对应参数的验证错误存入紧挨着的BindingResult中。你代码里的写法是正确的，但如果模型名称不匹配，即使BindingResult内存在错误，模板也无法将错误关联到对应的表单对象上。

其他可行修复方案 #

除了显式指定@ModelAttribute的名称，你也可以通过以下方式统一模型名称：

1. 修改Thymeleaf模板中的绑定对象：

<form th:action="@{/login}" th:object="${loginDetails}" method="post">
    <!-- 其他内容不变 -->
</form>

2. 修改GET方法中的模型属性名称：

@GetMapping
public String showLoginForm(Model model) {
    model.addAttribute("loginDetails", new LoginDetails());
    return "loginpage";
}

内容的提问来源于stack exchange，提问作者Agrudge Amicus