IP地址合法性校验,这个Java工具类4个方法纯字符不查DNS

📌 高并发系统设计 : 基于Redis与MQ的秒杀系统架构:库存预减、防超卖与限流防刷全流程解析

📋 目录

一、工具类功能

判断字符串是不是合法的 IPv4 或 IPv6 字面量,并把 IPv6 归一化展开成完整小写形式,纯字符判断不触发 DNS,不认 CIDR 前缀与端口写法。

二、所需环境

JDK 17或以上

三、方法与调用示例(按需调用)

🔢 方法序号:1

🎯 方法用途:

  • 判一个字符串是不是合法 IP 字面量,IPv4 与 IPv6 任一族通过就算通过
  • 白名单校验、接口入参兜底的第一道判断用它,纯本地字符匹配,不触发 DNS,结果也不随网络状态变化

🧩 方法定义 :public static boolean isValidIp(String ip)

🗣️ 入参解释 :public static boolean isValidIp(待校验字符串)

📤 返回值解释 :boolean,IPv4 或 IPv6 只要有一族结构合法就是 true

💡 边界口径:

  • 内部就是先判 IPv4 再判 IPv6,两族的文法互斥,不会同时通过
  • null、空串、垃圾输入一律返回 false,不抛异常
  • 只看字面量合不合法,端口与 CIDR 前缀都不解析,也不判断私有、链路本地这类地址属性

🧪 方法示例:

  • isValidIp("203.0.113.7") 按 IPv4 通过,拿到 true
  • isValidIp("2001:db8::1") 按 IPv6 通过,拿到 true
  • isValidIp("fe80::1%eth0") 带接口名的链路本地地址同样合法,拿到 true
  • isValidIp("::1") 回环缩写合法,拿到 true
  • isValidIp("1:2:3:4:5:6:1.2.3.4") 末两组内嵌 IPv4 的写法合法,拿到 true
  • isValidIp("1.2.3.4/24") 带子网前缀不认,拿到 false
  • isValidIp("1.2.3.4:8080") 带端口不认,拿到 false
  • isValidIp(null) 拿到 false
  • isValidIp("not-an-ip") 垃圾输入同样拿到 false,不抛异常

🔢 方法序号:2

🎯 方法用途:

  • 单独判 IPv4:必须恰好 4 段,每段 0 到 255,并且不允许前导零
  • 配置项、请求头里只收 IPv4 的场合用它,免得 IPv6 混进白名单

🧩 方法定义 :public static boolean isValidIpv4(String ip)

🗣️ 入参解释 :public static boolean isValidIpv4(待校验字符串)

📤 返回值解释 :boolean,四段全部通过十进制段校验才 true

💡 边界口径:

  • 前导零会被 inet_aton 一类解析器按八进制读,同一串字符在操作系统和 JVM 里可能读出不同地址,01.2.3.4、010.0.0.1 因此一律拒绝,单字符 0 合法
  • 超过 15 个字符直接返回 false,不进逐段解析
  • 段内的空格、加号等字符落在 0|[1-9]\d{0,2} 之外,256 这类越界值由上界判断挡住
  • IPv4 不支持区域标识,也不接受 /24 这种前缀写法

🧪 方法示例:

  • isValidIpv4("255.255.255.255") 拿到 true
  • isValidIpv4("01.2.3.4") 前导零歧义,拿到 false
  • isValidIpv4("010.0.0.1") 同理被拒,拿到 false
  • isValidIpv4("0.0.0.0") 单字符 0 合法,拿到 true
  • isValidIpv4("1.2.3.4.5") 段数不是 4,拿到 false
  • isValidIpv4("256.1.1.1") 取值越界,拿到 false
  • isValidIpv4(" 1.2.3.4") 段首带空格,拿到 false

🔢 方法序号:3

🎯 方法用途:

  • 单独判 IPv6,支持 :: 压缩、末尾内嵌 IPv4 和末尾的 % 区域标识
  • 需要把 IPv6 白名单条目卡死结构时用,压缩写法和完整写法都能认

🧩 方法定义 :public static boolean isValidIpv6(String ip)

🗣️ 入参解释 :public static boolean isValidIpv6(待校验字符串)

📤 返回值解释 :boolean,分组数与冒号位置都合规才 true

💡 边界口径:

  • 首尾只允许成对的 ::,:1:2:3:4:5:6:7:8、1:2:3:4:5:6:7:8:、:::: 与两处压缩一律非法
  • 没有压缩时必须正好 8 组;有压缩时显式分组之和要少于 8 组,也就是 :: 至少代表一组零
  • 内嵌 IPv4 只能出现在最后且占 2 组,::1.2.3.4:5 拒绝
  • 地址本体上限 45 字符,% 后面的接口名不计入这个长度,整个入参另有 256 字符的宽松上限
  • 整个串只允许一个 %,后面必须是非空且不含空白与控制字符的片段,fe80::1% 非法

🧪 方法示例:

  • isValidIpv6(":1:2:3:4:5:6:7:8") 开头单冒号,拿到 false
  • isValidIpv6("1:2:3:4:5:6:7:8:") 结尾单冒号,拿到 false
  • isValidIpv6("::::") 三个以上连续冒号,拿到 false
  • isValidIpv6("1:2::3::4") 两处压缩,拿到 false
  • isValidIpv6("1:2:3:4:5:6:7::8") 显式分组已满 8 组,:: 无零可代表,拿到 false
  • isValidIpv6("1:2:3:4:5:6::8") 少一组就合法,拿到 true
  • isValidIpv6("::1.2.3.4:5") 内嵌 IPv4 不在最后,拿到 false
  • isValidIpv6("2001:0db8:85a3:0000:0000:0000:0000:8a2e%wlan01") 接口名不计入长度上限,拿到 true
  • isValidIpv6("fe80::1%") 百分号后面为空,拿到 false
  • isValidIpv6("fe80::1%eth%0") 出现两个百分号,拿到 false

🔢 方法序号:4

🎯 方法用途:

  • 把合法的 IPv6 展开成不带 :: 压缩、不含区域标识的小写完整形式
  • 日志归一与地址比对用它,2001:DB8::1 和 2001:0db8:0:0:0:0:0:1 展开后是同一个字符串,可以直接 equals

🧩 方法定义 :public static String expandIpv6(String ip)

🗣️ 入参解释 :public static String expandIpv6(待展开字符串)

📤 返回值解释 :String,8 组 4 位小写十六进制、冒号分隔的完整地址;入参不是合法 IPv6 时为 null

💡 边界口径:

  • 先过一遍 IPv6 校验,非法就直接返回 null,不抛异常
  • 每组补齐到 4 位、整体转小写,压缩位置按缺几组补几个 0000
  • 内嵌 IPv4 会换算成高低位两个分组,192.0.2.1 落成 c000:0201
  • 带区域标识的先去掉 % 及其后的接口名,展开结果里不再保留
  • 展开结果本身仍是合法 IPv6,再展开一次不会变化

🧪 方法示例:

  • expandIpv6("2001:DB8::1") 拿到 2001:0db8:0000:0000:0000:0000:0000:0001
  • expandIpv6("2001:0DB8:0:0:0:0:0:1") 与压缩写法归一到同一个字符串,拿到 2001:0db8:0000:0000:0000:0000:0000:0001
  • expandIpv6("::") 压缩全零也还原成 8 组,拿到 0000:0000:0000:0000:0000:0000:0000:0000
  • expandIpv6("::ffff:192.0.2.1") 内嵌 IPv4 换成高低位分组,拿到 0000:0000:0000:0000:0000:ffff:c000:0201
  • expandIpv6("fe80::1%eth0") 去掉接口名后展开,拿到 fe80:0000:0000:0000:0000:0000:0000:0001
  • expandIpv6("1:2:3:4:5:6:7:8:9") 非法入参,拿到 null
  • 把 expandIpv6("2001:DB8::1") 的输出再喂回 expandIpv6 比一次,拿到 true

四、工具类源码(可直接复制)

📦 源码文件

相关推荐
斯维赤20 分钟前
SpringBoot接口调不通排查终极方案
java·后端·spring
山楂树の33 分钟前
Java BigDecimal笔记
java·开发语言
旋风菠萝1 小时前
HashMap和CurrentHashMap的key可以为空吗
java·数据库·redis
开开心心就好2 小时前
PDF水印怎么去掉?勾选对象再点匹配
java·前端·mysql·支持向量机·pdf·音视频·模拟退火算法
Flynn Liang2 小时前
Java 虚拟线程别乱用:I/O 密集型服务的线程模型与并发度计算
java·spring boot·性能优化·高并发·线程池·虚拟线程
飞奔的瓜牛3 小时前
Zabbix 部署与实战监控手册:Java 服务、端口、进程与邮件/企微告警
java·企业微信·zabbix
Java展博4 小时前
[Go 后端转场] 从 try-catch 到 if err != nil:写惯 Java 的人第一次上手最别扭的 4 件事
java·开发语言·golang
starzy19904 小时前
Hadoop介绍总结:一张图理清组件、生态与版本
java·hadoop
yyuuuzz4 小时前
nginx 502 排查,先看上游超时那一行
android·java·运维·nginx·502