crypto.randomUUID()符合安全规范，因其底层调用操作系统加密随机源（如/dev/urandom），生成RFC 4122 v4 UUID，122位真随机，碰撞概率低于1/2¹²²，且需运行在HTTPS/localhost安全上下文。
直接用 crypto.randomUUID()，只要环境满足安全上下文且浏览器/Node.js 版本够新，它就是最安全、最标准的方案。
crypto.randomUUID() 为什么算“符合安全规范”
它底层调用的是操作系统级加密随机源（如 Linux 的 /dev/urandom），不是 Math.random() 那种可预测的伪随机数。生成的是 RFC 4122 v4 UUID，128 位中真正随机的部分有 122 位，理论碰撞概率低于 1/2122 —— 工程上可视为“不会撞”。
关键点：
- 必须运行在安全上下文中：HTTPS、
localhost或127.0.0.1；HTTP 域名（如http://192.168.1.10）会直接报错TypeError: crypto.randomUUID is not a function - 不支持 IE 全系列；Chrome ≥92、Firefox ≥90、Safari ≥15.4、Edge ≥92 才可用
- Node.js 需 ≥14.17.0；低版本会提示
crypto.randomUUID is not a function
降级到 crypto.getRandomValues() 的实操写法
当 crypto.randomUUID() 不可用时，crypto.getRandomValues() 是唯一推荐的备选 —— 它同样基于加密随机源，只是需要手动拼装 UUID 字符串。
常见错误是照搬网上简版正则替换（比如只用 Math.random() 填 xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx），那根本不安全。
正确做法：
- 用
new Uint8Array(16)申请 16 字节缓冲区 - 调用
crypto.getRandomValues(buffer)填充真实加密随机值 - 手动设置第 7 字节（索引 6）的高 4 位为
0100（即版本号 v4） - 手动设置第 9 字节（索引 8）的高 2 位为
10（即 variant 1） - 最后按
8-4-4-4-12格式转成十六进制字符串
示例核心逻辑：
function generateUUID() {
if (typeof crypto !== 'undefined' && crypto.randomUUID) {
return crypto.randomUUID();
}
const buffer = new Uint8Array(16);
crypto.getRandomValues(buffer);
buffer[6] = (buffer[6] & 0x0f) | 0x40; // version 4
buffer[8] = (buffer[8] & 0x3f) | 0x80; // variant 1
return Array.from(buffer, b => b.toString(16).padStart(2, '0'))
.join('')
.replace(/^(.{8})(.{4})(.{4})(.{4})(.{12})$/, '$1-$2-$3-$4-$5');
}
哪些场景下不能依赖 crypto API
遇到这些情况，crypto 相关方法都会失效或不可用：
- 页面通过
file://协议打开（比如双击本地 HTML 文件） - 运行在旧版 WebView 中（如 Android 4.x 系统自带 WebView）
- 某些企业内网 HTTP 环境，既没 HTTPS 也没 localhost 权限
- Node.js --experimental-webcrypto 标志
此时若仍需 UUID，只能用第三方库（如 uuid npm 包）或接受 Math.random() 降级 —— 但后者明确不适用于会话令牌、支付 ID 等安全敏感场景。
容易被忽略的兼容性检查细节
很多人只检测 crypto 存在与否，却漏掉函数是否可调用：
-
typeof crypto === 'object'≠crypto.randomUUID可用；得加typeof crypto.randomUUID === 'function' - 某些 Polyfill（如 webcrypto-shim）可能挂载了
randomUUID但实际走的是Math.random()，务必验证返回值是否符合 v4 格式（第 13 位是4，第 18 位是8、9、a或b） - 服务端渲染（SSR）环境里，
crypto可能是 Node.js 的，也可能是浏览器的，需区分运行时上下文
真正安全的 UUID 生成，从来不只是“能跑出来”，而是从源头确保随机源可信、格式合规、环境受控 —— 这三者缺一不可。
