在 spring boot 中校验邮箱格式,最直接的办法是在实体类的字段上添加 @email 注解。这个注解属于 hibernate validator(jsr-380)规范,默认会检查字符串是否为非空且符合 rfc 5322 标准的邮箱格式。如果希望允许空值存在但仅在非空时校验,可以配合 nullable = true 使用,或者结合 @notblank 来确保必填。

@Email 注解的默认行为是什么
@Email 注解默认要求字段不能为 null,且必须符合特定的正则表达式规则。它不仅仅检查是否有 "@" 符号,还会验证域名部分的合法性。如果传入的值不符合格式,校验器会抛出 ConstraintViolationException 或在 BindingResult 中记录错误。这种校验是服务端的第一道防线,能有效拦截非法数据。

import jakarta.validation.constraints.Email;
import jakarta.validation.constraints.NotBlank;
public class UserDTO {
@NotBlank(message = "用户名不能为空")
private String username;
@Email(message = "邮箱格式不正确", nullable = false)
private String email;
}
// 测试输入:email = "invalid-email"
// 预期结果:校验失败,返回错误信息 "邮箱格式不正确"
如何配置 @Email 以支持更宽松或严格的校验
虽然默认的 @Email 已经相当严格,但在某些场景下可能需要调整。例如,有些内部系统可能只关心是否有 "@" 和域名后缀,而不需要完全符合 RFC 标准。此时可以通过自定义正则表达式来实现。另外,如果希望区分“必填”和“选填”,可以将 @Email 与 @Null 或 @NotNull 组合使用,或者利用 groups 属性在不同业务场景下应用不同的校验策略。

import jakarta.validation.constraints.Email;
import java.util.regex.Pattern;
public class FlexibleUserDTO {
// 仅当字段非空时校验,允许 null
@Email(message = "邮箱格式错误", regexp = ".+@.+\..+", flags = {Flag.IGNORE_CASE})
private String flexibleEmail;
}
// 测试输入:flexibleEmail = "test@example.com"
// 预期结果:校验通过
// 测试输入:flexibleEmail = null
// 预期结果:校验通过(因为允许null)
当邮箱字段为空字符串时,@Email 会如何处理
当邮箱字段被设置为空字符串 "" 时,@Email 注解的行为取决于是否同时使用了 @NotBlank 或 @NotEmpty。如果单独使用 @Email,空字符串通常会被视为无效邮箱并报错,因为空串不符合邮箱的正则匹配。如果希望空字符串被视为合法(即不校验),需要显式设置 allowEmptyStrings = true(注意:此属性在较新版本的 Hibernate Validator 中可能已被移除或行为改变,建议结合 @Null 或业务逻辑判断)。最稳妥的方式是使用 @NotBlank 确保非空,再用 @Email 确保格式,这样空字符串会在第一步就被拦截。











