Spring Boot验证错误消息无法展示问题求助（首次开发应用）

嘿，我来帮你排查下这个困扰你的问题！你遇到的核心问题是实体类上的验证注解没触发，导致errors集合为空，自然没法把错误消息展示给用户。咱们一步步来解决：

1. 确保引入验证依赖 #

Spring Boot 2.3及以上版本中，spring-boot-starter-web不再包含验证模块，所以你需要手动添加spring-boot-starter-validation依赖：

如果用Maven，在pom.xml中添加：

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

如果用Gradle，在build.gradle中添加：

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

没有这个依赖的话，@Size、@NotNull这些注解根本不会生效。

2. 在Controller中触发验证 #

你需要在接收的实体参数前加上@Valid注解，同时紧跟一个BindingResult对象来捕获验证错误——注意这两个参数必须紧挨着，BindingResult要放在被验证的实体参数后面，否则Spring会直接抛出异常而不是把错误存入BindingResult。示例代码如下：

@RequestMapping(value = "/create", method = RequestMethod.POST, consumes = MediaType.APPLICATION_FORM_URLENCODED_VALUE)
public String createUser(@Valid User user, BindingResult bindingResult, Model model) {
    // 先检查是否存在验证错误
    if (bindingResult.hasErrors()) {
        // 将错误消息存入Model，供前端获取
        model.addAttribute("errors", bindingResult.getAllErrors());
        // 返回表单页面，让用户修正输入
        return "create-form";
    }
    // 验证通过，保存数据到数据库
    userRepository.save(user);
    return "redirect:/users";
}

3. 前端正确渲染错误消息 #

假设你用Thymeleaf作为模板引擎，可以这样遍历所有错误：

<ul th:if="${errors != null and errors.size() > 0}">
    <li th:each="error : ${errors}" th:text="${error.defaultMessage}"></li>
</ul>

或者针对单个字段展示错误：

<div th:if="${#fields.hasErrors('address')}">
    <p class="text-danger" th:errors="*{address}"></p>
</div>

4. 确认实体类被正确扫描 #

确保你的实体类所在的包在Spring Boot启动类的扫描范围内（默认扫描启动类同包及子包），如果不在的话，需要在启动类上添加@ComponentScan指定扫描路径。

按照上面的步骤排查后，应该就能触发验证逻辑，errors集合也会正确获取到验证错误，前端就能展示你定义的Address is invalid.这类错误消息了。

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