UUID v4、v7 和 v1 有什么区别,该用哪个
什么时候用 UUID v4,什么时候用 v7、v1?为什么 v7 终于成了新表主键的合理默认。位布局、真实场景配方,以及那些没人提醒你的坑。
UUID 无处不在——请求 id、主键、分布式追踪、幂等 token、文件名。大多数人学会 v4 后就把 crypto.randomUUID() 复制到所有项目里,不再多想。这套用法长期没问题,直到 v7 标准化,于是又有了重新审视字母表的理由。本文讲清楚每个版本到底装了什么、各自适合哪些场景,以及那些悄悄把「唯一」id 变成重复的小错误。
UUID 是什么,为什么用它
UUID(与 GUID 同义)是 128 位标识符,常以 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 形式呈现。它的两个核心特性让它好用:可以在多处独立生成、不依赖中央协调;正确生成时几乎不会冲突。这就是数据库、消息队列、CDN、特性开关系统都偏爱它的原因。
代价是:每个 id 占用 36 个 ASCII 字符,比 64 位整型大;同时它的字节顺序对人类不友好,对偏好顺序键的索引也不友好。版本之间的取舍基本都围绕第二点。
UUID v4、v7 和 v1 的区别
三个版本都共用 128 位长度和固定位置的 version + variant 半字节,差异在于剩余位填什么。
| 版本 | 时间位 | 随机位 | 其他 | 是否可排序 |
|---|---|---|---|---|
| v4 | 0 | 122 | - | 否 |
| v7 | 48(Unix 毫秒) | 74 | 6(version + variant) | 是(按时间) |
| v1 | 60(自 1582 年起 100ns) | 至多 62(含随机 node) | 14(clock seq)+ 48(node) | 是,但字节顺序错位 |
v4 是「全随机」。无偏、易推理,是 web 上最常见的默认值。缺点是连续生成的 v4 id 散落在键空间各处,对喜欢局部性的 B-tree 索引不友好。
v7 正好解决了这个问题。前 48 位是大端 Unix 毫秒时间戳,意味着字典序自然等于时间序。剩下 74 位随机,足以让同毫秒同机器生成的两个 id 几乎不可能撞。这是 2026 年新表主键的合理默认。
v1 是最早的时间排序方案,但时间字段被拆成 time-low / time-mid / time-hi,按字节排序并不得到时间序。v1 还以把 MAC 地址嵌入 node id 而出名——隐私上的隐患。现代 v1 生成器(包括本工具)会用随机的组播 node id 替代真实 MAC,格式仍合法但不再泄露硬件。
不同场景选哪个版本
Postgres 主键:选 v7。 单调递增的键让索引最右叶始终热,写入只触碰少量页,缓冲池保持温热。大表上这就是 OLTP 工作负载快与慢的分水岭。Postgres 近版本已内置 UUIDv7 函数,但只要时钟大致同步,客户端生成同样可靠。
事件流 / 幂等 token:v4 就够。 当请求 id 只需要唯一且不可猜,v4 的 122 位纯熵是最简单也最安全的选择。这种用哈希查找的键,时间排序毫无收益。
从 v1 迁移:保留列,新写入用 v7。 UUID 列接受任意版本,无需 schema 变更。新行直接享受时间排序优势,旧行继续工作。若需按时间范围查,建议另存 created_at 列——比从 UUID 反解字节更划算。
文件名 / 对象存储键:v7。 可排序 UUID 非常适合 S3 风格的桶前缀(按字典序列出)。你可以用前几个十六进制字符直接列出「这一小时的全部对象」。
对外 URL:v4。 时间排序的 id 会泄露创建时间,有时是隐私问题(例如「用户 17」早于「用户 18」就能推出谁先注册)。对外暴露的 id 用 v4。
常见陷阱
用 Math.random() 自己拼
Math.random() 快,但不是密码学级别。两个状态相近的浏览器可能产生重叠输出,每次调用的熵远低于 122 位。随机部分必须用 crypto.randomUUID() 或 crypto.getRandomValues()。本工具两个都用,仅在规范要求处做手工位运算。
把 v7 当成「永不冲突」
v7 每毫秒每进程有 74 位随机。意味着大约 2^37(约 1370 亿)个 id/毫秒后才会逼近生日界。正常负载远到不了,但若你在多线程间共享同一时间戳来分片,请给每个线程独立的生成器状态,避免争用全局变量。规范还定义了「单调随机」子模式:在同一毫秒内递增,对单机高并发场景是个不错的额外保险。
把 UUID 当 secret token
UUID 是唯一,不是秘密。v1 和 v7 一定程度上可预测(时间戳就明摆着),即便 v4 也只有 122 位,远不及会话 token 期望的 256 位。需要 bearer 凭据时,请用 crypto.getRandomValues(new Uint8Array(32)) 然后 base64-url 编码。UUID 用来「命名一个东西」,不是「证明你是谁」。
老 v1 库泄露 MAC
最初的 v1 用网卡 MAC 作为 node id,把每个 id 绑回具体设备——正是隐私法规最反感的指纹。本工具的 v1 生成器(以及任何现代库)会置组播位并使用随机字节,格式仍合法,真实硬件标识永不出现。
有横线 vs 无横线
部分系统去掉横线(紧凑形式 32 个十六进制字符)以省字节。一致使用没问题,混用就会出事:插入时是 c0a8...、查询时是 c0a8-...,匹配不上。每个系统选定一种规范形式,存进去,仅在展示时格式化。
常见问题
crypto.randomUUID() 算密码学安全吗? 算。规范要求使用 CSPRNG 并正确设置 version + variant 位。本工具的 v4 路径优先委托给它,仅在不支持时回退到手写实现。
v7 id 可以按字符串排序吗? 可以。36 字符形式的字典序与时间序一致,因为时间戳在前且大端。
为什么要「浪费」位给 version 和 variant? 它们让消费者识别格式、检测是否为泄露 MAC 的 v1 或畸形字符串。128 位里花掉 6 位换得自描述能力,划算。
v6 和 v8 呢? v6 是把 v1 重新排序后的版本(时间戳在前、可排序),适合迁移历史包袱,但基本被 v7 取代。v8 是「自定义版本」,由应用决定布局。除非有特殊需要,坚持 v4 和 v7。
打开我们的 UUID 生成器 同台体验 v4、v7、v1,最多批量 100 个并下载为 .txt。需要更多随机工具?密码请用 密码生成器,公平抽取请用 抽签工具。