Java中包装类配合@Valid等注解可实现DTO自动校验：用Integer等替代基本类型以支持null，结合@NotNull、@Min等注解精准约束；Controller中用@Valid+@RequestBody触发校验；全局异常处理器统一返回错误字段及提示。
Java 中包装类本身不直接参与校验，但配合 Spring Boot 的 @Valid、@Validated 以及 JSR-303/380（如 Hibernate Validator）注解，可以实现前端传参（如 JSON）到后端 DTO 对象的自动校验。关键在于：包装类（如 Integer、Boolean、LocalDateTime 等）支持空值，而校验注解能精准控制其是否允许为 null 或满足其他约束。
1. 使用包装类 + 校验注解定义 DTO
避免使用基本类型（如 int、boolean），改用包装类（Integer、Boolean），这样字段可为 null，便于配合 @NotNull、@Min、@Pattern 等注解做语义化校验。
示例：
public class UserDTO {
@NotNull(message = "用户ID不能为空")
private Long id;
@NotBlank(message = "用户名不能为空")
private String username;
@Min(value = 0, message = "年龄不能小于0")
private Integer age; // 包装类，允许为 null；加 @Min 后，若传了值则必须 ≥ 0
@Email(message = "邮箱格式不正确")
private String email;
@Future(message = "注册时间不能是过去时间")
private LocalDateTime registerTime;
}
2. 在 Controller 中启用自动校验
使用 @Valid 或 @Validated 注解标注参数，并配合 @RequestBody 接收 JSON。Spring 会在绑定参数后自动触发校验，失败时抛出 MethodArgumentNotValidException（针对 @Valid）或 ConstraintViolationException（针对 @Validated）。
立即学习“Java免费学习笔记（深入）”；
- 推荐用
@Valid配合@RequestBody，适用于单个对象校验 - 若需分组校验（如新增/更新不同规则），用
@Validated({CreateGroup.class}) - 务必确保项目已引入
spring-boot-starter-validation
3. 统一处理校验失败（返回友好提示）
通过全局异常处理器捕获校验异常，提取错误信息并返回标准响应结构：
@RestControllerAdvice
public class ValidationExceptionHandler {
@ExceptionHandler(MethodArgumentNotValidException.class)
public ResponseEntity<Map<String, String>> handleValidationExceptions(
MethodArgumentNotValidException ex) {
Map<String, String> errors = new HashMap<>();
ex.getBindingResult().getAllErrors().forEach((error) -> {
String fieldName = ((FieldError) error).getField();
String errorMessage = error.getDefaultMessage();
errors.put(fieldName, errorMessage);
});
return ResponseEntity.badRequest().body(errors);
}
}
这样前端提交：{"username":"","age":-5}，会收到：{"username":"用户名不能为空","age":"年龄不能小于0"}
4. 注意包装类与校验逻辑的配合细节
-
@NotNull检查是否为null，适合包装类；而@NotEmpty和@NotBlank仅适用于CharSequence（如String） -
Integer字段加@Min(1)：若前端传"age": null，不触发@Min（因值为null，跳过数值校验）；若传"age": -2，则触发并报错 - 若要求“必须传且大于 0”，就同时加
@NotNull+@Min(1) - 日期类（
LocalDateTime）需配合@DateTimeFormat（用于字符串解析）和@Future/@Past（用于逻辑校验）
