Hibernate @Email校验是否不要求域名后缀？Spring Boot技术问题

你遇到的这个情况完全符合Hibernate Validator的默认行为——默认的@Email注解确实不要求域名包含.com/.io这类公共后缀，哪怕是fakeemail@a这种看起来“不完整”的格式，也会被判定为合法。

为什么会这样？ #

Hibernate Validator的@Email注解默认遵循RFC 5322定义的宽松邮箱格式规范，这个规范的核心要求只是邮箱结构符合本地部分@域名部分的基本形式：

• 必须有且仅有一个@符号
• @前后的内容都不能为空
• 内容符合RFC 5322允许的字符规则

而RFC 5322本身并没有强制域名部分必须带后缀，因为很多内部系统或私有网络中的邮箱（比如john@company、admin@local）本身就不需要公共后缀，Hibernate Validator的默认设计是为了兼容这类场景。

如果需要强制域名带后缀怎么办？ #

如果你希望校验更严格，要求域名必须包含类似.com/.org的后缀，可以通过以下两种方式实现：

1. 结合@Pattern注解自定义正则校验

在@Email之外，添加@Pattern注解配合正则表达式，强制域名部分包含后缀：

@Email(message = "邮箱格式不正确")
@Pattern(
    regexp = "^[a-zA-Z0-9_+&*-]+(?:\\.[a-zA-Z0-9_+&*-]+)*@(?:[a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,}$",
    message = "邮箱域名需包含至少2个字符的后缀（如.com/.io）"
)
private String email;

这个正则会要求：

• 域名部分至少有一个.
• 最后一段后缀长度至少为2个字符（覆盖常见的.com/.io/.org等格式）

2. 自定义邮箱校验器

如果正则满足不了你的复杂需求，可以自定义一个校验注解和对应的校验器：

// 自定义注解
@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = StrictEmailValidator.class)
public @interface StrictEmail {
    String message() default "邮箱格式不正确，需包含合法后缀";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

// 校验器实现
public class StrictEmailValidator implements ConstraintValidator<StrictEmail, String> {
    private static final String EMAIL_REGEX = "^[a-zA-Z0-9_+&*-]+(?:\\.[a-zA-Z0-9_+&*-]+)*@(?:[a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,}$";
    private Pattern pattern;

    @Override
    public void initialize(StrictEmail constraintAnnotation) {
        pattern = Pattern.compile(EMAIL_REGEX);
    }

    @Override
    public boolean isValid(String email, ConstraintValidatorContext context) {
        if (email == null || email.isEmpty()) {
            return false;
        }
        Matcher matcher = pattern.matcher(email);
        return matcher.matches();
    }
}

之后直接在POJO字段上使用@StrictEmail即可。

版本说明 #

你使用的6.0.9.Final版本（以及后续的Hibernate Validator版本）都保持了这个默认行为，因为框架的设计理念是提供基础的格式校验，而把严格校验的控制权交给开发者。

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