如何重写Hibernate Validator的内置@Email验证器？

要替换Hibernate Validator内置的@Email验证器（基于已废弃的RFC2822）为符合RFC5322标准的自定义实现，可按以下步骤操作：

步骤1：实现自定义RFC5322邮件验证器 #

实现ConstraintValidator<Email, String>接口，编写符合RFC5322的校验逻辑。推荐使用成熟的第三方库（如Apache Commons Validator）避免手动编写正则的疏漏：

import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;
import org.hibernate.validator.constraints.Email;
import org.apache.commons.validator.routines.EmailValidator;

public class RFC5322EmailValidator implements ConstraintValidator<Email, String> {

    private EmailValidator rfc5322Validator;

    @Override
    public void initialize(Email constraintAnnotation) {
        // 初始化严格模式的RFC5322验证器
        this.rfc5322Validator = EmailValidator.getInstance(true);
    }

    @Override
    public boolean isValid(String email, ConstraintValidatorContext context) {
        // 空值逻辑与内置验证器保持一致：允许空值（若需强制非空需搭配@NotNull）
        if (email == null || email.isBlank()) {
            return true;
        }
        return rfc5322Validator.isValid(email);
    }
}

如果不想依赖第三方库，可使用RFC5322标准正则（注意：复杂正则可能存在边缘场景疏漏）：

import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;
import org.hibernate.validator.constraints.Email;
import java.util.regex.Pattern;

public class RFC5322EmailValidator implements ConstraintValidator<Email, String> {

    private static final String RFC5322_REGEX = "^[a-zA-Z0-9_!#$%&'*+/=?`{|}~^.-]+@[a-zA-Z0-9.-]+$";
    private Pattern emailPattern;

    @Override
    public void initialize(Email constraintAnnotation) {
        this.emailPattern = Pattern.compile(RFC5322_REGEX);
    }

    @Override
    public boolean isValid(String email, ConstraintValidatorContext context) {
        if (email == null || email.isBlank()) {
            return true;
        }
        return emailPattern.matcher(email).matches();
    }
}

步骤2：替换内置@Email验证器 #

有两种方式完成替换：

方式一：编程式注册（使用ConstraintDefinitionContributor） #

实现ConstraintDefinitionContributor接口，将自定义验证器绑定到@Email注解：

import org.hibernate.validator.constraints.Email;
import org.hibernate.validator.spi.constraintdefinition.ConstraintDefinitionContributor;
import org.hibernate.validator.spi.constraintdefinition.ConstraintDefinitionContribution;

public class EmailConstraintDefinitionContributor implements ConstraintDefinitionContributor {

    @Override
    public void contribute(ConstraintDefinitionContribution contribution) {
        contribution.constraint(Email.class)
                .validatedBy(RFC5322EmailValidator.class);
    }
}

然后在src/main/resources/META-INF/services目录下创建文件org.hibernate.validator.spi.constraintdefinition.ConstraintDefinitionContributor，写入自定义Contributor的全类名：

com.yourpackage.EmailConstraintDefinitionContributor

方式二：声明式配置（使用validation.xml） #

在src/main/resources/META-INF/validation.xml中配置替换规则：

<?xml version="1.0" encoding="UTF-8"?>
<validation-config xmlns="https://jakarta.ee/xml/ns/validation/configuration"
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                   xsi:schemaLocation="https://jakarta.ee/xml/ns/validation/configuration https://jakarta.ee/xml/ns/validation/configuration/validation-configuration-3.0.xsd"
                   version="3.0">
    <constraint-definition annotation="org.hibernate.validator.constraints.Email">
        <!-- include-existing-validators设为false完全替换内置验证器 -->
        <validated-by include-existing-validators="false">
            <value>com.yourpackage.RFC5322EmailValidator</value>
        </validated-by>
    </constraint-definition>
</validation-config>

验证使用 #

现在使用@Email注解时，将自动采用你的RFC5322验证逻辑：

public class User {
    @Email(message = "邮箱格式不符合RFC5322标准")
    private String email;

    // getter、setter方法
}

内容的提问来源于stack exchange，提问作者Rezan Achmad