Spring Boot表单验证BindingResult错误未显示，报500错误

你的问题核心是Spring的BindingResult没有接住验证错误，导致直接抛出ConstraintViolationException引发500错误，而非将错误传递到页面展示。以下是排查和解决步骤：

1. 检查@Valid的导入包与BindingResult位置 #

• 确保@Valid是jakarta.validation.Valid（Spring Boot 3+必须用jakarta包，旧javax包会导致验证逻辑异常）
• BindingResult必须紧跟在@Valid修饰的参数后面，否则Spring会跳过错误捕获，直接抛异常：

@PostMapping("/create")
public String createPost(@Valid @ModelAttribute("post") Post post, 
                         BindingResult bindingResult, 
                         Model model) {
    // 先处理错误，再执行业务逻辑
    if (bindingResult.hasErrors()) {
        return "post-form"; // 返回表单页，携带错误信息
    }
    postService.save(post);
    return "redirect:/posts";
}

2. 避免提前触发JPA验证 #

如果在判断bindingResult.hasErrors()之前就调用了postRepository.save(post)，JPA会触发自身的实体验证，抛出ConstraintViolationException。必须先校验再持久化：

// 错误写法：先保存再判断错误
postRepository.save(post);
if (bindingResult.hasErrors()) {
    return "post-form";
}

// 正确写法：先判断错误，再保存
if (bindingResult.hasErrors()) {
    return "post-form";
}
postRepository.save(post);

3. 校验实体类注解的正确性 #

确保实体类的校验注解是jakarta.validation.constraints包下的，而非旧javax包：

import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Size;

public class Post {
    @NotBlank(message = "标题不能为空")
    @Size(min = 2, max = 100, message = "标题长度需在2-100字符之间")
    private String title;

    @NotBlank(message = "内容不能为空")
    private String content;

    // getter/setter
}

4. 检查Thymeleaf视图的错误渲染逻辑 #

确保表单正确绑定实体对象，且错误提示与字段对应：

<!-- 表单必须用th:object绑定到Model中的post对象 -->
<form th:action="@{/create}" th:object="${post}" method="post">
    <div class="form-group">
        <label>标题</label>
        <input type="text" th:field="*{title}" class="form-control">
        <!-- 显示对应字段的错误信息 -->
        <span th:if="${#fields.hasErrors('title')}" 
              th:errors="*{title}" 
              class="text-danger"></span>
    </div>
    <div class="form-group">
        <label>内容</label>
        <textarea th:field="*{content}" class="form-control"></textarea>
        <span th:if="${#fields.hasErrors('content')}" 
              th:errors="*{content}" 
              class="text-danger"></span>
    </div>
    <button type="submit">提交</button>
</form>

5. 关闭JPA自动验证（可选） #

如果以上步骤都排查过仍有问题，可能是JPA在保存时强制触发了验证，可以在application.properties中关闭：

# Spring Boot 3+ 用jakarta键
spring.jpa.properties.jakarta.persistence.validation.mode=none
# 旧版本用javax键
# spring.jpa.properties.javax.persistence.validation.mode=none

内容的提问来源于stack exchange，提问作者Денис Шульженко