Spring Boot中@Valid注解验证JSON失效问题求助

核心问题分析 #

1. 依赖版本冲突：Spring Boot 3.x 基于Jakarta EE规范，你手动引入的hibernate-validator:6.1.6.Final是Java EE时代的版本，和Spring Boot 3.3.0内置的验证组件不兼容，直接导致部分验证规则失效。
2. 缺少验证异常处理：即使验证逻辑生效，若未捕获MethodArgumentNotValidException并返回错误响应，前端无法感知验证失败，会误以为请求被正常处理。
3. DTO字段访问性：验证框架需要读取字段值，若未提供getter方法，可能导致验证逻辑无法正常执行。

分步解决方案 #

1. 修复依赖配置 #

删除pom.xml中手动引入的hibernate-validator依赖，spring-boot-starter-validation已经包含了适配Spring Boot 3.x的验证实现，无需额外引入：

<!-- 移除这行冗余依赖 -->
<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>6.1.6.Final</version>
</dependency>

2. 完善DTO类 #

给DTO添加getter/setter方法，或者用已引入的Lombok@Data注解简化代码，同时确保使用Jakarta EE的验证注解：

import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import lombok.Data;

@Data
public class TaskDto {
    private Long id;

    @NotBlank(message = "任务描述不能为空")
    private String description;

    @NotNull(message = "完成状态不能为空")
    private Boolean completed;
}

注意：Spring Boot 3.x中必须使用jakarta.validation.constraints包下的注解，而非旧的javax.validation包。

3. 增强验证异常处理 #

推荐使用全局异常处理器统一拦截验证失败请求，避免每个Controller重复处理：

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.BindException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

import java.util.stream.Collectors;

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(BindException.class)
    public ResponseEntity<RestResponse> handleBindException(BindException ex) {
        String errorMsg = ex.getBindingResult().getAllErrors().stream()
                .map(error -> error.getDefaultMessage())
                .collect(Collectors.joining("; "));
        return ResponseEntity.status(HttpStatus.BAD_REQUEST)
                .body(RestResponse.of(HttpStatus.BAD_REQUEST, errorMsg, null));
    }
}

如果只想在当前Controller处理，也可以添加BindingResult参数捕获错误：

@PostMapping(value = CREATE_TASK, produces = MediaType.APPLICATION_JSON_VALUE)
@Schema(description = "Create task")
public RestResponse createTask(@Valid @RequestBody TaskDto taskDto, BindingResult bindingResult) {
    if (bindingResult.hasErrors()) {
        String errorMsg = bindingResult.getAllErrors().stream()
                .map(error -> error.getDefaultMessage())
                .collect(Collectors.joining("; "));
        return RestResponse.of(HttpStatus.BAD_REQUEST, errorMsg, null);
    }
    taskService.createTask(taskDto);
    return RestResponse.of(HttpStatus.OK,
            "Task" + taskDto.getDescription() +" succesfully created",
            null);
}

4. 验证空JSON场景 #

提交空JSON时，Jackson会将description和completed设为null，分别触发@NotBlank和@NotNull规则，验证框架会拦截请求并返回400错误响应。

验证效果测试 #

1. 提交空JSON：返回400错误，提示"任务描述不能为空; 完成状态不能为空"
2. 仅传description：返回400错误，提示"完成状态不能为空"
3. 仅传completed：返回400错误，提示"任务描述不能为空"
4. 传全合法字段：正常返回200成功响应

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