Spring Boot与Thymeleaf验证功能无法正常工作求助

我之前开发的时候也踩过这个坑，结合你给出的代码片段，咱们从几个关键环节排查解决：

1. 确保BindingResult的参数顺序正确 #

这是最容易踩的坑！BindingResult必须紧跟在被@Valid注解的模型对象后面，你的代码里看起来顺序是对的，但再确认下：

// 正确顺序：@Valid模型 → BindingResult → 其他参数
public String createNewBusiness(@Valid @ModelAttribute("business") Business business, 
                                BindingResult result, 
                                Model model) {
    // ...
}

如果把BindingResult放在Model之后，Spring会直接抛出验证异常，而不会把错误信息绑定到BindingResult里，自然页面就看不到错误了。

2. 修正Thymeleaf页面的错误显示逻辑 #

页面里必须正确关联模型对象和错误字段，步骤如下：

• 首先给表单加上th:object="${business}"，和控制器里的@ModelAttribute("business")对应：

<form th:action="@{/create}" th:object="${business}" method="post">
    <!-- 表单输入项 -->
</form>

• 然后在地址输入框下方添加错误提示区域，用Thymeleaf的#fields工具类和th:errors标签：

<div class="form-group">
    <label for="address">Address</label>
    <input type="text" th:field="*{address}" class="form-control" id="address"/>
    <!-- 错误提示 -->
    <div th:if="${#fields.hasErrors('address')}" class="text-danger">
        <p th:errors="*{address}"></p>
    </div>
</div>

这里要用*{address}而不是${business.address}，因为th:object已经指定了当前模型对象，这样Thymeleaf才能正确关联验证错误。

3. 控制器里添加错误判断逻辑 #

当验证出错时，你需要返回表单页面，而不是继续执行后续的业务逻辑，这样错误信息才会被带到页面上：

@RequestMapping(value = "/create", method = RequestMethod.POST, consumes = MediaType.APPLICATION_FORM_URLENCODED_VALUE)
public String createNewBusiness(@Valid @ModelAttribute("business") Business business, 
                                BindingResult result, 
                                Model model) {
    // 先判断是否有验证错误
    if (result.hasErrors()) {
        // 返回表单页面，保留用户输入和错误信息
        return "business/create-form"; // 替换成你的表单页面名称
    }
    // 没有错误才执行保存等操作
    // model.addAttribute(...);
    // businessRepository.save(business);
    return "redirect:/success"; // 成功后重定向
}

4. 确认Validation依赖是否存在（Spring Boot 2.3+） #

从Spring Boot 2.3版本开始，spring-boot-starter-validation不再默认包含在web starter里，你需要手动添加依赖：

Maven #

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

Gradle #

implementation 'org.springframework.boot:spring-boot-starter-validation'

如果没有这个依赖，你的验证注解根本不会生效，自然也不会有错误信息。

5. 检查模型属性名称是否一致 #

控制器里@ModelAttribute("business")的名称是business，页面里th:object="${business}"必须完全匹配，不能写错成biz或者其他名称，否则Thymeleaf找不到对应的模型对象，错误信息也无法显示。

按照这几步排查下来，应该就能解决验证错误不显示的问题了！

内容的提问来源于stack exchange，提问作者Dejan Sipovac