深入Hibernate Validator：手把手教你自定义校验注解，搞定手机号、身份证等复杂规则

在Java开发中，数据校验是保证系统健壮性的第一道防线。虽然Spring Validation提供了@NotNull、@Size等基础注解，但面对手机号、身份证号、银行卡号等业务特定规则时，这些通用注解就显得力不从心。本文将带你深入Hibernate Validator的扩展机制，从零开始实现一个可复用的手机号校验注解，并拓展到更复杂的业务场景。

1. 为什么需要自定义校验注解？

想象这样一个场景：你的用户注册接口需要验证手机号格式。如果直接在业务代码中写正则校验，会有几个明显问题：

• 代码重复：每个接收手机号的接口都要复制粘贴相同的校验逻辑
• 可读性差：业务代码被一堆if-else校验语句污染
• 维护困难：当手机号规则变化时，需要修改所有相关代码

Hibernate Validator的扩展机制可以完美解决这些问题。通过自定义注解，你可以：

java复制public class UserDTO {
    @Mobile // 自定义的手机号校验注解
    private String phone;
    // 其他字段...
}

这种声明式校验不仅简洁优雅，还能与Spring Validation无缝集成，自动触发校验并返回标准化的错误信息。

2. 自定义注解的三步曲

2.1 定义注解接口

首先创建一个@Mobile注解，核心要素包括：

java复制@Documented
@Target({FIELD, PARAMETER})
@Retention(RUNTIME)
@Constraint(validatedBy = MobileValidator.class)
public @interface Mobile {
    String message() default "手机号格式不正确";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
    
    // 可配置的正则表达式参数
    String regexp() default "^1[3-9]\\d{9}$";
}

关键点说明：

• @Constraint指定校验器的实现类
• message支持国际化消息配置
• groups实现分组校验（如区分新增/修改场景）
• payload可携带元数据供校验器使用

2.2 实现校验逻辑

创建ConstraintValidator实现类处理实际校验：

java复制public class MobileValidator implements ConstraintValidator<Mobile, String> {
    private Pattern pattern;
    
    @Override
    public void initialize(Mobile constraintAnnotation) {
        // 初始化时编译正则表达式
        pattern = Pattern.compile(constraintAnnotation.regexp());
    }

    @Override