如何在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}$");
    }
}