如何在Spring Boot 项目中自定义 Validation 注解

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;
@Target({ElementType.FIELD, ElementType.PARAMETER}) // 作用于字段和方法参数
@Retention(RetentionPolicy.RUNTIME) // 运行时生效
@Constraint(validatedBy = PhoneValidator.class) // 关联校验器
public @interface Phone {
    String message() default "手机号格式错误"; // 错误提示
    Class<?>[] groups() default {}; // 分组校验（如新增、更新）
    Class<? extends Payload>[] payload() default {}; // 负载信息（可选）
    String region() default "CN"; // 自定义属性：地区（默认中国）
}

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
public class PhoneValidator implements ConstraintValidator<Phone, String> {
    private String region; // 存储注解的region属性
    @Override
    public void initialize(Phone constraintAnnotation) {
        this.region = constraintAnnotation.region(); // 初始化，获取地区配置
    }
    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        if (value == null) return true; // 允许为空（若必填需额外处理，如@NotBlank配合使用）
        // 根据地区校验格式
        switch (region) {
            case "CN": // 中国手机号：11位，以1开头，第二位3-9
                return value.matches("^1[3-9]\\d{9}$");
            case "US": // 美国手机号：+1开头，后跟10位数字
                return value.matches("^\\+1\\d{10}$");
            default:
                return false; // 未知地区，校验失败
        }
    }
}

public class UserDTO {
    @NotBlank
    private String username;
    @Phone(region = "CN") // 校验中国手机号
    private String phone;
    // 若需校验美国手机号，可设置region="US"
    // @Phone(region = "US")
    // private String usPhone;
    // getters/setters
}

import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;
@RestController
public class UserController {
    @PostMapping("/register")
    public String register(@Validated @RequestBody UserDTO dto) {
        // 校验通过，执行注册逻辑
        return "注册成功";
    }
}

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.BindingResult;
import org.springframework.validation.FieldError;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<ErrorResponse> handleValidationError(MethodArgumentNotValidException ex) {
        BindingResult result = ex.getBindingResult();
        StringBuilder errorMsg = new StringBuilder();
        for (FieldError error : result.getFieldErrors()) {
            errorMsg.append(error.getField()).append(": ").append(error.getDefaultMessage()).append("; ");
        }
        return ResponseEntity
                .status(HttpStatus.BAD_REQUEST)
                .body(new ErrorResponse(HttpStatus.BAD_REQUEST.value(), errorMsg.toString()));
    }
    static class ErrorResponse {
        private int code;
        private String message;
        public ErrorResponse(int code, String message) {
            this.code = code;
            this.message = message;
        }
        // getters
    }
}

// 定义分组接口
public interface CreateGroup {}
public interface UpdateGroup {}
// 在DTO中指定分组
@Phone(region = "CN", groups = CreateGroup.class) // 新增时校验手机号
private String phone;
// Controller中使用分组
@PostMapping("/create")
public String create(@Validated(CreateGroup.class) @RequestBody UserDTO dto) { ... }
@PutMapping("/update")
public String update(@Validated(UpdateGroup.class) @RequestBody UserDTO dto) { ... }

Phone.message=手机号格式错误（中文）
Phone.message_en=Invalid phone number format（英文）

// 校验器中注入Service（需将校验器标记为@Component，由Spring管理）
@Component
public class PhoneValidator implements ConstraintValidator<Phone, String> {
    @Autowired
    private UserService userService; // 假设UserService提供手机号唯一性查询
    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        // 先校验格式，再校验唯一性
        if (!isFormatValid(value)) return false;
        return !userService.existsByPhone(value); // 假设existsByPhone查询数据库
    }
    private boolean isFormatValid(String value) {
        // 复用之前的格式校验逻辑
        return value.matches("^1[3-9]\\d{9}$");
    }
}