Thymeleaf表单校验错误无法在页面显示问题求助

1. 实体类校验注解配置问题 #

• 确保description字段添加了合法的JSR-380校验注解（如@NotBlank、@Size），且已引入校验依赖（Spring Boot项目需引入spring-boot-starter-validation）。
• 示例代码：

import javax.validation.constraints.NotBlank;
import javax.validation.constraints.Size;

public class Recipe {
    private Long id;
    
    @NotBlank(message = "描述不能为空")
    @Size(min = 3, message = "描述长度至少3个字符")
    private String description;

    // 生成getter、setter方法
}

2. 控制器方法配置问题 #

• 提交表单的方法参数必须添加@Valid注解，且BindingResult对象必须紧跟在@Valid修饰的参数之后，用于捕获校验错误。
• 示例代码：

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.validation.BindingResult;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;

import javax.validation.Valid;

@Controller
public class RecipeController {

    @GetMapping("/recipe/form")
    public String showForm(Model model) {
        model.addAttribute("recipe", new Recipe());
        return "recipeform";
    }

    @PostMapping("/recipe/save")
    public String saveRecipe(@Valid Recipe recipe, BindingResult bindingResult) {
        // 校验失败时直接返回表单页面，保留错误信息
        if (bindingResult.hasErrors()) {
            return "recipeform";
        }
        // 校验成功后的业务逻辑
        return "redirect:/recipe/list";
    }
}

3. Thymeleaf页面错误展示配置问题 #

• 页面需通过th:object="${recipe}"绑定模型中的实体对象，表单元素使用th:field绑定字段，再通过#fields工具类获取错误信息。
• 示例页面代码片段：

<html xmlns:th="http://www.thymeleaf.org">
<body>
<form th:action="@{/recipe/save}" th:object="${recipe}" method="post">
    <div class="form-group">
        <label for="description">描述:</label>
        <input type="text" th:field="*{description}" class="form-control" id="description">
        <!-- 展示description字段的校验错误 -->
        <div th:if="${#fields.hasErrors('description')}" th:errors="*{description}" class="text-danger"></div>
    </div>
    <button type="submit" class="btn btn-primary">保存</button>
</form>
</body>
</html>

4. 其他排查点 #

• 避免校验失败后使用redirect:返回页面，重定向会丢失BindingResult中的错误信息，需直接返回视图名称。
• 确认页面已正确引入Thymeleaf命名空间，否则所有Thymeleaf指令无法生效。

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