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

简介: 这是一个轻量IP校验与IPv6归一化工具类,支持JDK17+。提供4个核心方法:`isValidIp`(统判IPv4/IPv6)、`isValidIpv4`(严格IPv4校验)、`isValidIpv6`(完整IPv6语法校验)及`expandIpv6`(IPv6展开为小写全格式),纯本地字符解析,不依赖DNS,不处理端口与CIDR。

📋 目录

一、工具类功能

判断字符串是不是合法的 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

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

📦 源码文件

相关文章
|
18天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
7660 57
|
3天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1442 0
|
5天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
18天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5672 68
|
6天前
|
云安全 人工智能 安全
|
13天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
2896 9
|
5天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
3天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
1848 0
|
10天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1868 1