当前位置:首页 > 文章列表 > 数据库 > MySQL > MySQL INET6_NTOA 怎样把二进制地址恢复成 IPv6 文本

MySQL INET6_NTOA 怎样把二进制地址恢复成 IPv6 文本

来源:17golang原创 2026-11-19 09:48:51 0浏览 收藏

如果表里保存的是 INET6_ATON() 产生的二进制地址,查询时不要把它直接当普通字符串拼出来。恢复可读地址的直接写法是:

-- 把 IPv6 的二进制网络地址恢复成标准文本
SELECT INET6_NTOA(addr_bin) AS addr_text
FROM client_address;

INET6_NTOA() 接收 IPv4 或 IPv6 的二进制网络地址,返回连接字符集中的地址文本;参数为 NULL 或不是合法地址时返回 NULL。IPv6 结果使用小写字母,返回文本最长为 39 个字符。

官方地址:https://dev.mysql.com/doc/refman/8.4/en/miscellaneous-functions.html#function_inet6-ntoa

先看懂 INET6_ATON 和 INET6_NTOA 的关系

这两个函数是一对方向相反的转换函数:写入时用 INET6_ATON('文本地址') 得到网络字节序的二进制值,读取时用 INET6_NTOA(二进制值) 还原为文本。IPv6 需要 16 字节,IPv4 需要 4 字节,因此适合放在 VARBINARY(16) 列中。

INET6_ATON 与 INET6_NTOA 在文本地址和二进制地址之间往返转换的静态关系图
图1:转换链路说明图,展示文本地址、网络字节序二进制值与 INET6_NTOA 的关系,不是截图或运行证据。
-- 用同一条表达式演示写入方向和读取方向
WITH sample AS (
    SELECT INET6_ATON('fdfe::5a55:caff:fefa:9089') AS addr_bin
)
SELECT
    HEX(addr_bin) AS binary_hex,
    INET6_NTOA(addr_bin) AS addr_text
FROM sample;

结果中的十六进制串只是为了观察二进制内容;真正展示给用户的字段应使用 INET6_NTOA() 的返回值。

IPv6 和 IPv4 都可以用同一个函数读取

函数名带有 6,不代表只能处理 IPv6。MySQL 文档规定,INET6_ATON() 也能把 IPv4 转成 4 字节二进制值,INET6_NTOA() 再把它恢复成点分十进制文本。因此一个同时保存 IPv4、IPv6 的地址列可以共用读取表达式。

-- 分别读取 16 字节 IPv6 和 4 字节 IPv4
WITH sample AS (
    SELECT 'ipv6' AS kind, INET6_ATON('fdfe::5a55:caff:fefa:9089') AS addr_bin
    UNION ALL
    SELECT 'ipv4', INET6_ATON('10.0.5.9')
)
SELECT
    kind,
    OCTET_LENGTH(addr_bin) AS byte_length,
    INET6_NTOA(addr_bin) AS addr_text
FROM sample;

这里的 OCTET_LENGTH() 只用于观察输入占用的字节数:IPv6 通常是 16,IPv4 通常是 4。它不能替代有效性判断,但很适合排查“为什么某一行转换为空”。

返回 NULL 时先区分三种情况

INET6_NTOA() 返回 NULL 不等于“地址文本本来就是空字符串”。常见原因有三类:列值为 NULL、输入二进制长度不是 4 或 16 字节、内容不是有效的网络地址二进制表示。查询时可以把长度和转换结果一起带出来。

-- 同时暴露原值长度与转换结果,方便定位 NULL 来源
SELECT
    id,
    OCTET_LENGTH(addr_bin) AS byte_length,
    CASE
        WHEN addr_bin IS NULL THEN '输入为 NULL'
        WHEN OCTET_LENGTH(addr_bin) IN (4, 16) THEN '长度可转换'
        ELSE '长度不是 IPv4/IPv6 地址'
    END AS input_state,
    INET6_NTOA(addr_bin) AS addr_text
FROM client_address;

长度检查是诊断提示,不是完整的地址校验。对外展示时应保留原始二进制值的可追踪标识,并把 NULL 视为“没有可转换地址”,不要在应用层悄悄替换成 0.0.0.0 或 ::。

INET6_NTOA 对 IPv4、IPv6、NULL 和非法长度输入的静态边界说明图
图2:输入边界说明图,比较 4 字节、16 字节、NULL 和非法长度的处理路径,不是截图或运行证据。

在业务查询中同时保留二进制检索和文本展示

地址列使用二进制形式,通常是为了节省空间、避免文本格式差异,或者让 IPv4 和 IPv6 使用统一字段。不要为了展示而把原列改成文本;在 SELECT 层派生一个可读字段即可。

-- 原始列用于精确筛选,派生列用于日志和接口展示
SELECT
    id,
    addr_bin,
    INET6_NTOA(addr_bin) AS addr_text,
    created_at
FROM client_address
WHERE addr_bin = INET6_ATON('2001:db8::8a2e:370:7334')
ORDER BY created_at DESC;

筛选条件两边保持二进制类型,避免对列本身套函数后再做比较。展示字段只出现在结果集里,既不破坏索引路径,也能让日志和接口读者看到标准地址文本。

几个容易忽略的输出细节

问题正确理解
IPv6 会不会保留大写不会依赖输入大小写,输出使用小写字母。
文本列要预留多长最长按 39 个字符考虑,适用于最长的 IPv6 文本表示。
NULL 能否当成默认地址不能直接当成有效地址;先区分缺失值与转换失败。
能否把 HEX(addr_bin) 当作地址不能。HEX 只是调试二进制,地址展示应使用 INET6_NTOA。
IPv4 是否必须单独写 INET_NTOA不必;INET6_NTOA 可读取 INET6_ATON 生成的 IPv4 二进制值。

总结

MySQL 中恢复二进制网络地址的核心就是 INET6_NTOA(addr_bin)。把它放在查询结果层,能够同时满足二进制列的存储/筛选需求和文本地址的展示需求。排查 NULL 时,再结合 addr_bin IS NULL 与 OCTET_LENGTH(addr_bin) 区分缺失值、错误长度和正常的 IPv4/IPv6 输入。

相关问题

INET6_NTOA 能直接处理普通字符串 IPv6 吗?

不能把普通文本当作二进制地址使用。先用 INET6_ATON() 转换,再把返回值交给 INET6_NTOA()。

为什么查询结果里 IPv6 的字母变成小写?

这是函数的规范化输出行为,不表示地址发生变化;IPv6 十六进制字母大小写不影响地址含义。

INET6_NTOA 返回 NULL 怎么办?

先判断原列是否为 NULL,再检查二进制长度是否为 4 或 16,并回溯写入端是否确实使用了 INET6_ATON。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
MySQL 窗口函数怎样保留每组排名第一行MySQL 窗口函数怎样保留每组排名第一行
上一篇
MySQL 窗口函数怎样保留每组排名第一行
MySQL JSON_REMOVE 怎样一次删除多个路径
下一篇
MySQL JSON_REMOVE 怎样一次删除多个路径
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1110次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1101次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1273次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1215次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1062次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码