INET_ATON和INET_NTOA仅支持IPv4,须用INT UNSIGNED存储并配合CAST转无符号,IPv6必须用INET6_ATON/INET6_NTOA配合VARBINARY(16),不可混用。

直接用 INET_ATON 和 INET_NTOA,别自己写函数
MySQL 原生函数已经足够高效且经过充分验证,自定义函数不仅没性能优势,反而引入额外开销和维护成本。你写的函数哪怕逻辑完全正确,执行速度也大概率慢于内置函数——因为 INET_ATON 是 C 层实现、无字符串解析循环、不走 SQL 解析器路径。
常见误区是认为“自己拆分 + CAST + 位运算”更可控,但实测在百万行数据上,SELECT INET_ATON(ip_str) 比手写 SUBSTRING_INDEX + POW 组合快 3~5 倍,且内存占用更低。
除非你有极特殊需求(比如兼容非标准格式如 "010.0.0.1" 或带端口的 "192.168.1.1:8080"),否则不要碰自定义函数。
INET_ATON 返回负数?字段必须定义为 INT UNSIGNED
这是最常踩的坑:INET_ATON('255.255.255.255') 在 MySQL 内部返回的是 BIGINT SIGNED 值 4294967295,但按有符号解释会显示为 -1;如果目标字段是 INT(默认有符号),插入时会被截断或报错(取决于 SQL 模式)。
- 建表时明确指定:
ip_int INT UNSIGNED NOT NULL - 插入时强制无符号语义:
INSERT INTO t(ip_int) VALUES(CAST(INET_ATON('192.168.1.1') AS UNSIGNED)) - 千万别省略
CAST(... AS UNSIGNED)—— 即使字段是UNSIGNED,函数返回值本身的符号性仍会影响隐式转换行为
INET_NTOA 突然全返回 NULL?先查字段类型和数值范围
INET_NTOA 对输入极其敏感:只要参数不是严格落在 0~4294967295 的无符号整数区间内,就静默返回 NULL。而这个“静默”恰恰最危险——它不报错,查出来全是空,容易误判为数据丢失。
典型诱因:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 字段定义为
INT(有符号),存了INET_ATON('192.168.255.255')→ 实际存成负数-16777217,喂给INET_NTOA就是NULL - 从外部系统导入整数 IP 时,来源未校验,混入了
4294967296或负值 - 用
SELECT INET_NTOA(ip_int)直接查,没做兜底,结果集里大量NULL却没意识到是类型错配
调试建议:SELECT ip_int, INET_NTOA(CAST(ip_int AS UNSIGNED)) FROM t WHERE ip_int 4294967295; —— 这条能立刻暴露问题数据。
IPv6 怎么办?INET_ATON 完全不能用,必须切到 INET6_ATON
传 '::1' 给 INET_ATON 不报错,只返回 NULL;传 '192.168.1.1' 给 INET6_ATON 也不报错,但返回的是 16 字节二进制值(0x000000000000000000000000C0A80101),跟 INET_ATON 的 4 字节整数完全不兼容。
所以:
- 不要试图用一个字段同时存 IPv4 和 IPv6 —— 类型冲突无法绕过
- IPv4 场景统一用
INT UNSIGNED+INET_ATON/INET_NTOA - IPv6 或双栈场景,改用
VARBINARY(16)字段 +INET6_ATON/INET6_NTOA,且查询逻辑要单独写 - 混合查询(如“查所有来自 192.168.1.x 或 ::1 的请求”)必须拆成两个子查询再
UNION,没法用单个索引高效完成
真正麻烦的从来不是函数怎么调,而是设计阶段没想清楚 IPv4/IPv6 是否共存、以及共存时的数据模型是否可维护。










