spring boot 中校验域名格式应使用 @pattern 注解配合正则表达式,并在自定义 constraintvalidator 中调用 inetaddress.issitelocaladdress() 排除内网 ip。这样能确保输入既符合域名规范又非本地地址。

如何配置正则与自定义校验器
通过继承 PatternValidator 或实现 ConstraintValidator 接口,可以扩展默认的 @Pattern 行为。在 isValid 方法中,先检查字符串是否匹配域名正则,再验证是否为内网 IP。

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
import java.net.InetAddress;
import java.net.UnknownHostException;
public class DomainValidator implements ConstraintValidator<validdomain string> {
private static final String DOMAIN_REGEX = "^[a-zA-Z0-9]([a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9\-]{0,61}[a-zA-Z0-9])?)*$";
@Override
public boolean isValid(String value, ConstraintValidatorContext context) {
if (value == null || value.isEmpty()) return true;
if (!value.matches(DOMAIN_REGEX)) return false;
try {
InetAddress addr = InetAddress.getByName(value);
return !addr.isSiteLocalAddress();
} catch (UnknownHostException e) {
return false;
}
}
}</validdomain>
如何在实体类中应用该校验
在 DTO 或实体类的字段上添加 @ValidDomain 注解,即可在请求进入时自动触发校验逻辑。若校验失败,将抛出 MethodArgumentNotValidException。

import lombok.Data;
import javax.validation.constraints.NotNull;
@Data
public class ServerConfigDTO {
@NotNull
@ValidDomain(message = "Invalid domain or local IP")
private String serverDomain;
}
当输入为纯数字 IP 时会发生什么
如果输入是合法的公网 IP(如 8.8.8.8),由于不匹配域名正则,校验会直接返回 false。若需支持 IP 和域名混合校验,需调整正则表达式或使用 @NotBlank 结合其他逻辑。











