Spring MVC中@Valid与BindingResult校验失效问题排查

我开发了一个活动注册功能，要求所有字段不能为空：若字段为空，显示提示信息且不保存活动到数据库。

我在EventController中编写了如下方法：

@PostMapping(value = "/registerEvent")
public String form(@Valid Event event,
                   BindingResult bindingResult, RedirectAttributes redirectAttributes) {
    if (bindingResult.hasErrors()) {
        redirectAttributes.addFlashAttribute("message",
                "Couldn't register this event. Check all fields and try again.");
        return "redirect:/registerEvent";
    }

    eventRepository.save(event);
    redirectAttributes.addFlashAttribute("message",
            "Event successfully registered!");

    return "redirect:/registerEvent";
}

Event实体类定义：

//imports

@Entity
public class Event implements Serializable {

    @Serial
    private static final long serialVersionUID = 1L;

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;

    @NotEmpty
    private String name;

    @NotEmpty
    private String venue;

    @NotNull
    private LocalDate date;

    @NotNull
    private LocalTime time;


//other attributes and any methods

}

registerEvent页面代码：

<div class="row container">
    <p>Name: <span th:text="${event.name}"></span></p>
    <p>Venue: <span th:text="${event.venue}"></span></p>
    <p>Date: <span th:text="${event.date}"></span></p>
    <p>Time: <span th:text="${event.time}"></span></p>

    <h5 style="text-align: center;">You can sign up for "<span th:text="${event.name}"></span>" by filling the form below:</h5>
    <form method="post">
        Name: <input type="text" value="" name="name" id="name">
        Rg: <input type="text" value="" name="rg" id="rg">
        <button class="btn waves-effect waves-light" type="submit" name="action">Sign up
            <i class="material-icons right">send</i>
        </button>
    </form>

    <th:block th:include="validationMessage"></th:block>

<!--etc.-->

页面引入的validationMessage.html：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Validation message</title>
</head>
<body>
<div class="alert alert-success alert-dismissible" role="alert" th:if="${not #strings.isEmpty(message)}">
    <h5 th:text="${message}" style="color: blue;"></h5>
</div>
</body>
</html>

实际运行时，留空字段提交后，空活动依然被保存到数据库（name和venue为空，date和time为NULL），且始终显示“Event successfully registered!”，完全没触发验证逻辑。请问问题出在哪里？

核心问题是业务逻辑混淆+验证配置/表单不匹配，具体分以下几点：

1. 最关键：搞混了「创建活动」和「用户报名活动」的逻辑 #

从页面文本You can sign up for "xxx" by filling the form below可以看出，这个表单是用户报名已有活动的入口，但你的控制器却在接收Event实体、尝试保存新活动——表单提交的是用户的name和rg，完全没有Event需要的venue、date、time字段，这直接导致Spring MVC无法正确绑定Event对象，验证自然失效。

2. 验证依赖缺失（大概率） #

如果你的项目是Spring Boot，必须引入spring-boot-starter-validation依赖，否则@Valid注解不会生效，bindingResult永远不会检测到错误：

• 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'
  

3. 验证注解使用不当 #

• @NotEmpty只校验字符串非空且长度>0，但如果字段根本没被赋值（为null），它不会触发错误——对于字符串类型的必填字段，应该用@NotBlank（校验非null、非空串、非空白字符）。
• @NotNull对于LocalDate/LocalTime字段，如果表单没传对应参数，Spring MVC会把字段设为null，但如果没有依赖，或者表单根本没有对应输入框，验证也不会触发。

4. 表单与接收对象不匹配 #

如果你的需求是创建新活动，表单必须包含Event的所有必填字段：

<form method="post">
    Name: <input type="text" name="name" id="name" required>
    Venue: <input type="text" name="venue" id="venue" required>
    Date: <input type="date" name="date" id="date" required>
    Time: <input type="time" name="time" id="time" required>
    <button class="btn waves-effect waves-light" type="submit" name="action">Register Event
        <i class="material-icons right">send</i>
    </button>
</form>

如果你的需求是用户报名已有活动，需要重新设计报名DTO和控制器：

第一步：创建报名DTO #

public class EventRegistration {
    @NotBlank(message = "姓名不能为空")
    private String userName;
    @NotBlank(message = "RG不能为空")
    private String rg;
    @NotNull(message = "请选择活动")
    private Long eventId; // 关联已有的活动ID

    // Getters & Setters
}

第二步：修改控制器方法 #

@PostMapping(value = "/registerEvent")
public String registerForEvent(@Valid EventRegistration registration,
                               BindingResult bindingResult,
                               RedirectAttributes redirectAttributes) {
    if (bindingResult.hasErrors()) {
        redirectAttributes.addFlashAttribute("message", "报名失败，请检查所有字段后重试。");
        return "redirect:/registerEvent";
    }
    // 根据eventId查询对应的活动，保存报名记录
    Event event = eventRepository.findById(registration.getEventId())
            .orElseThrow(() -> new IllegalArgumentException("活动不存在"));
    // 假设你有EventRegistrationRepository
    eventRegistrationRepository.save(registration);
    
    redirectAttributes.addFlashAttribute("message", "报名成功！");
    return "redirect:/registerEvent";
}

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