在 spring boot 中校验 ip 地址,最稳妥的做法是自定义一个注解配合 validator 实现类,利用 java 的 inet4address 或 inet6address 进行解析。直接调用 inetaddress.getbyname() 可以验证格式合法性并排除主机名解析,从而确保输入的是纯 ip 字符串。

如何定义支持 IPv4 和 IPv6 的自定义注解
通过组合 @Constraint 和 validatedBy 属性,可以将校验逻辑绑定到具体的类上。这样在 Controller 的参数对象中使用该注解时,Spring 会自动触发校验逻辑。

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;
@Documented
@Constraint(validatedBy = {IpValidator.class})
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
public @interface ValidIp {
String message() default "Invalid IP address";
Class>[] groups() default {};
Class extends Payload>[] payload() default {};
}
对应的 Validator 实现类需要处理空值判断,因为非空校验通常由 @NotNull 负责。这里重点在于解析逻辑,如果解析失败则抛出异常或返回 false。

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
import java.net.InetAddress;
import java.net.UnknownHostException;
public class IpValidator implements ConstraintValidator<validip string> {
@Override
public boolean isValid(String value, ConstraintValidatorContext context) {
if (value == null || value.isEmpty()) {
return true;
}
try {
InetAddress address = InetAddress.getByName(value);
return address != null;
} catch (UnknownHostException e) {
return false;
}
}
}</validip>
如何在 Controller 中应用该注解并获取错误信息
在 DTO 类中直接使用 @ValidIp 标注字段,并在 Controller 方法参数前加上 @Valid 即可触发全局校验。如果校验失败,Spring Boot 会抛出 MethodArgumentNotValidException。
import lombok.Data;
import javax.validation.constraints.NotNull;
@Data
public class IpRequest {
@NotNull
@ValidIp
private String clientIp;
}
在全局异常处理器中捕获该异常,提取具体的 FieldError 信息,将校验失败的 IP 字段和错误消息返回给前端。这种方式比使用正则表达式更可靠,因为它利用了 JDK 底层的网络协议栈进行验证。
当输入包含端口号或特殊字符时校验结果如何
如果传入的字符串包含端口号(如 192.168.1.1:8080)或非 IP 字符,InetAddress.getByName() 会抛出 UnknownHostException,导致校验返回 false。这种严格模式适合后端服务间通信场景,若需兼容带端口的输入,需在 Validator 中先截取 IP 部分再解析。











