<!-- Spring Validation 核心依賴 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>
<!-- Web依賴（若項目已引入可忽略） -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

import jakarta.validation.constraints.*; // Spring Boot 3.x使用jakarta包，2.x為javax包

public class UserDTO {
    // 主鍵非空
    @NotNull(message = "用戶ID不能為空")
    private Long id;

    // 用戶名非空且長度1-20
    @NotBlank(message = "用戶名不能為空")
    @Size(min = 1, max = 20, message = "用戶名長度需在1-20字符之間")
    private String username;

    // 年齡18-60歲
    @Min(value = 18, message = "年齡不能小于18歲")
    @Max(value = 60, message = "年齡不能大于60歲")
    private Integer age;

    // 郵箱格式合法
    @Email(message = "郵箱格式不正確")
    private String email;

    // getter/setter省略
}

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import jakarta.validation.Valid;

@RestController
public class UserController {
    // 新增用戶接口，@Valid觸發(fā)UserDTO的校驗
    @PostMapping("/user/add")
    public String addUser(@Valid @RequestBody UserDTO userDTO) {
        // 校驗通過后執(zhí)行業(yè)務(wù)邏輯
        return "用戶新增成功：" + userDTO.getUsername();
    }
}

import lombok.AllArgsConstructor;
import lombok.Data;

@Data
@AllArgsConstructor
public class Result<T> {
    // 狀態(tài)碼：200成功，400參數(shù)錯誤，500系統(tǒng)錯誤
    private Integer code;
    // 提示信息
    private String message;
    // 響應(yīng)數(shù)據(jù)（成功時返回，失敗時為null）
    private T data;

    // 靜態(tài)工廠方法：參數(shù)錯誤響應(yīng)
    public static Result<Void> paramError(String message) {
        return new Result<>(400, message, null);
    }

    // 靜態(tài)工廠方法：成功響應(yīng)（可省略）
    public static <T> Result<T> success(T data) {
        return new Result<>(200, "success", data);
    }
}

import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import jakarta.validation.ConstraintViolation;
import jakarta.validation.ConstraintViolationException;
import java.util.stream.Collectors;

// 全局異常處理，作用于所有@RestController
@RestControllerAdvice
public class GlobalValidationExceptionHandler {

    /**
     * 處理請求體參數(shù)校驗失?。ˊRequestBody + @Valid）
     * 異常類型：MethodArgumentNotValidException
     */
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public Result<Void> handleMethodArgumentNotValid(MethodArgumentNotValidException e) {
        // 提取所有字段的錯誤信息（如多個參數(shù)校驗失敗，合并提示）
        String errorMsg = e.getBindingResult().getFieldErrors().stream()
                .map(FieldError::getDefaultMessage) // 獲取每個字段的自定義錯誤信息
                .collect(Collectors.joining("；")); // 用“；”分隔多個錯誤

        // 返回參數(shù)錯誤響應(yīng)
        return Result.paramError(errorMsg);
    }

    /**
     * 處理路徑參數(shù)/請求參數(shù)校驗失敗（如@RequestParam/@PathVariable）
     * 異常類型：ConstraintViolationException
     */
    @ExceptionHandler(ConstraintViolationException.class)
    public Result<Void> handleConstraintViolation(ConstraintViolationException e) {
        // 提取參數(shù)錯誤信息
        String errorMsg = e.getConstraintViolations().stream()
                .map(ConstraintViolation::getMessage)
                .collect(Collectors.joining("；"));

        return Result.paramError(errorMsg);
    }
}

{
  "id": 1,
  "username": "",
  "age": 17,
  "email": "invalid-email"
}

{
  "code": 400,
  "message": "用戶名不能為空；年齡不能小于18歲；郵箱格式不正確",
  "data": null
}

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import jakarta.validation.constraints.Min;

@GetMapping("/user/{userId}")
public String getUser(@Min(value = 1, message = "用戶ID不能小于1") @PathVariable Long userId) {
    return "查詢用戶ID：" + userId;
}

{
  "code": 400,
  "message": "用戶ID不能小于1",
  "data": null
}