在 spring boot 中,使用 @validated 注解进行参数校验的核心做法是:在 controller 方法或类上添加 @validated 以开启校验功能,并在需要校验的参数前加上具体的约束注解(如 @notnull、@min)。当请求参数违反约束条件时,spring 会自动抛出 methodargumentnotvalidexception 异常。通过配置全局异常处理器捕获该异常,即可向客户端返回结构化的错误信息。

如何在校验失败时统一处理异常并返回 JSON
直接回答:通过实现 ControllerAdvice 并捕获 MethodArgumentNotValidException,可以拦截所有因 @Validated 触发的校验错误,提取具体的字段错误信息并封装为统一的 JSON 响应格式。

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import java.util.HashMap;
import java.util.Map;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<Map<String, Object>> handleValidationExceptions(
MethodArgumentNotValidException ex) {
Map<String, Object> body = new HashMap<>();
body.put("status", 400);
body.put("error", "Validation Failed");
// 提取第一个字段的错误消息作为示例
String errorMsg = ex.getBindingResult().getFieldErrors().stream()
.map(e -> e.getField() + ": " + e.getDefaultMessage())
.findFirst()
.orElse("Unknown error");
body.put("message", errorMsg);
return ResponseEntity.badRequest().body(body);
}
}预期结果:当传入的 age 为负数时,接口返回:{"status": 400, "error": "Validation Failed", "message": "age: must be greater than or equal to 0"}
如何在 Controller 类级别应用分组校验
直接回答:通过在 @Validated 中指定 groups 属性,或在 DTO 的约束注解中指定 groups,可以实现不同场景下的差异化校验逻辑。例如,创建用户时不需要校验 ID,而更新用户时需要校验 ID 存在。

import javax.validation.constraints.NotNull;
import javax.validation.constraints.Size;
import org.hibernate.validator.groups.Constraints;
// 定义分组接口
public interface CreateGroup {}
public interface UpdateGroup {}
public class UserDTO {
@NotNull(groups = UpdateGroup.class)
private Long id;
@Size(min = 2, groups = CreateGroup.class)
private String username;
// Getter and Setter
}
// Controller 中使用
@PostMapping(value = "/users", consumes = MediaType.APPLICATION_JSON_VALUE)
public ResponseEntity<UserDTO> createUser(
@Validated(CreateGroup.class) @RequestBody UserDTO user) {
// 仅校验 CreateGroup 中的约束
return ResponseEntity.ok(user);
}预期结果:在 createUser 接口中,如果 username 长度小于 2,校验失败;如果 id 为 null,校验通过(因为未应用 UpdateGroup)。
基于 UserDTO 中 username 字段的 @Size 约束的具体问题
直接回答:当 UserDTO 中的 username 字段被 @Size(min = 2) 约束时,如果传入的字符串长度小于 2,校验器会拒绝该请求。这一行为依赖于 Hibernate Validator 的实现,它会在绑定阶段检查字符序列的长度属性。


















