MySQL IS_IPV4_COMPAT 怎样识别 IPv4 兼容地址
来源:17golang原创
时间:2026-11-17 20:30:22 496浏览 收藏
MySQL IS_IPV4_COMPAT() 接收二进制形式的 IPv6 地址。对于地址文本,先调用 INET6_ATON(),再把结果交给它;返回 1 表示 IPv4-compatible IPv6,返回 0 表示不属于这一类,输入 NULL 则返回 NULL。它识别的是地址类别,不是所有含 IPv4 尾部的 IPv6 地址。
如果我需要整理一列混合地址,会先把“能否解析”和“属于哪种地址”拆开。这样非法文本不会因为一个 COALESCE 就悄悄变成普通的“非兼容地址”。本文以 MySQL 8.4 文档为依据,示例仅说明查询写法,没有本地执行记录。
官方文档:https://dev.mysql.com/doc/refman/8.4/en/miscellaneous-functions.html
先确定识别对象与输入范围
IPv4-compatible 的常见文本形式为 ::IPv4地址,例如 ::192.0.2.37;mapped 形式则带有 ::ffff: 前缀,例如 ::ffff:192.0.2.37。两者即使尾部相同,也不能用同一个分类标签代替。IS_IPV4_MAPPED() 是区分后者的配套函数。
不要通过是否包含点号来分类:IPv6 地址的低位也可以写成十六进制,不一定以点分十进制结尾。也不要简单检查文本是否以 :: 开头,因为缩写、特殊地址和不同合法表示会让文本规则偏离二进制含义。这里让 MySQL 的解析与分类函数承担各自职责。
对纯 IPv4 文本,INET6_ATON() 产生 4 字节结果;对 IPv6 文本,产生 16 字节结果。需要混合存放时,VARBINARY(16) 能保留两种长度。若用固定 BINARY(16) 保存纯 IPv4 的 4 字节结果,填充后的值不再是原来的长度,后续不能再按同样的长度逻辑分类。
准备二进制地址并完成最小查询
先用受控的示例文本说明函数组合,再观察长度与十六进制表示。下列三个分类表达式的预期值分别为 1、0、1;这是依据函数定义说明的结果,不是现场查询截图。
-- 文本先转换为二进制,不能直接把地址字符串交给分类函数。
SELECT
IS_IPV4_COMPAT(INET6_ATON('::192.0.2.37')) AS compatible,
IS_IPV4_COMPAT(INET6_ATON('::ffff:192.0.2.37')) AS mapped_as_compatible,
IS_IPV4_MAPPED(INET6_ATON('::ffff:192.0.2.37')) AS mapped;
-- 同时观察长度和十六进制,避免把客户端显示方式当成字段类型。
SELECT
OCTET_LENGTH(INET6_ATON('::192.0.2.37')) AS address_bytes,
HEX(INET6_ATON('::192.0.2.37')) AS address_hex;
第一个地址转换后的长度应为 16 字节,其低 32 位对应示例 IPv4 部分。HEX() 仅为观察字节提供可读表示,不改变 IS_IPV4_COMPAT() 需要二进制输入这一约定。传入 HEX() 的结果会得到文本字符,不能把它作为原二进制值继续分类。

如果数据本身已经是 INET6_ATON() 产生的二进制列,可直接调用 IS_IPV4_COMPAT(ip_bin),不必转成文本再转换回来。关键是确认列中保存的到底是原始字节、HEX 文本,还是 Base64 文本,而不是只看客户端显示出来像什么。
把分类结果放进数据查询
实际查询通常需要同时保留缺失、无效、纯 IPv4 和两种 IPv6 嵌入形式。下面用两层 CTE 分开描述原始文本与解析结果,再通过 CASE 给出标签。样本中的地址用于文档说明,不发起网络连接。
-- CTE 只创建本条查询的数据集,不创建或修改业务表。
WITH samples AS (
SELECT 1 AS id, '::192.0.2.37' AS ip_text
UNION ALL SELECT 2, '::ffff:192.0.2.37'
UNION ALL SELECT 3, '2001:db8::37'
UNION ALL SELECT 4, '192.0.2.37'
UNION ALL SELECT 5, 'not-an-ip'
UNION ALL SELECT 6, NULL
), parsed AS (
SELECT id, ip_text, INET6_ATON(ip_text) AS ip_bin
FROM samples
)
SELECT id, ip_text,
OCTET_LENGTH(ip_bin) AS address_bytes,
CASE
WHEN ip_text IS NULL THEN 'missing'
WHEN ip_bin IS NULL THEN 'invalid'
WHEN OCTET_LENGTH(ip_bin) = 4 THEN 'ipv4'
WHEN IS_IPV4_COMPAT(ip_bin) = 1 THEN 'compatible'
WHEN IS_IPV4_MAPPED(ip_bin) = 1 THEN 'mapped'
ELSE 'other-ipv6'
END AS address_kind
FROM parsed
ORDER BY id;
id 为 1 的样本应标记 compatible,2 为 mapped,3 为 other-ipv6,4 为 ipv4,5 为 invalid,6 为 missing。先检查 ip_text IS NULL,再检查 ip_bin IS NULL,能够保留输入缺失和解析失败的区别。这里的 other-ipv6 只表示没有命中前述两类,不证明地址可达、可分配或适合作为客户端来源。
CTE 的目的在于清楚表达查询结构,不承诺数据库只计算一次 INET6_ATON();优化器可能改写表达式。若只想筛选 compatible 行,在已有二进制地址列上使用 IS_IPV4_COMPAT(ip_bin) = 1 即可。不要对整列盲目解码,先确认存储约定。

处理兼容情况与使用限制
| 输入情况 | 处理要点 |
|---|---|
| 地址文本 | 先 INET6_ATON,再做二进制分类 |
| 已有二进制地址 | 直接分类,保留原始长度 |
| mapped 地址 | 用 IS_IPV4_MAPPED 单独标记 |
| 非法地址文本 | 解析结果为 NULL,单列为 invalid |
| 缺失值 | 保留 missing,避免与 invalid 混淆 |
这组表达式适用于提供相应函数的 MySQL 环境。若运行在其他数据库或兼容层,先以该产品的函数支持说明为准,不能仅凭它支持 MySQL 协议就推断行为一致。没有对应函数时,可以在应用层使用明确支持地址类别的 IP 库,并保持同样的缺失、无效与类别标签;不建议用 SQL 文本前缀替代二进制判断。
对大量记录反复在 WHERE 中解析文本,会增加转换计算;是否需要保存标准化二进制列或专用类别列,应结合数据更新方式与查询需求决定。本文没有性能测量,不给出“函数查询自动命中索引”或固定提速比例的承诺。使用持久化类别时,应确保地址变化与类别更新保持一致。
IS_IPV4_COMPAT 返回 0,是否说明输入是合法 IPv6?
不能这样推断。0 只表示没有识别为目标类别。面对文本输入,应先检查 INET6_ATON 是否成功,必要时再区分 4 字节和 16 字节结果。
为什么不要直接写 IS_IPV4_COMPAT(ip_text)?
因为该函数要求二进制 IPv6 表示。地址文本里的冒号、数字和点号是字符,并不是解析后的地址字节。文本列应先交给 INET6_ATON。
compatible 与 mapped 可以统一存成一个业务标签吗?
可以在明确的业务需求下另建总类,但底层识别仍应保留两者区别。不要让后续使用方误以为两个函数互相等价;更不能把地址分类结果直接当作访问授权或网络可达性的结论。
这套写法适合混合 IP 字段的数据整理:先确定存储表示,再保留解析状态,最后识别具体类别。对我而言,能解释 NULL 与 0 各代表什么,比只拿到一个布尔结果更有用。
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
148 收藏
-
234 收藏
-
490 收藏
-
273 收藏
-
171 收藏
-
428 收藏
-
204 收藏
-
497 收藏
-
242 收藏
-
211 收藏
-
486 收藏
-
304 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习