Mac上iOS模拟器出现“crypto.randomUUID is not a function”错误求助

核心原因 #

iOS模拟器的Safari并非完全复刻真实设备的Web环境，部分Web API支持存在细微差异，crypto.randomUUID报错主要和以下几个因素有关：

• 模拟器iOS版本不匹配：crypto.randomUUID从Safari 15.4（对应iOS 15.4）开始支持，若你使用的模拟器iOS版本低于15.4，而真实设备是15.4+，就会出现支持差异。
• Safari开发者设置异常：模拟器的Safari可能被意外开启了旧版WebKit模拟、JavaScript禁用等限制项，导致API无法正常调用。
• 模拟器缓存或状态异常：长期使用的模拟器可能残留缓存或异常状态，影响Web API的正常加载。

解决步骤 #

• 核对模拟器iOS版本：打开Xcode的「Devices and Simulators」，检查当前模拟器的iOS版本，确保和你测试的真实设备版本一致。若版本过低，下载对应版本的模拟器镜像后重新测试。
• 检查Safari开发者设置：
  1. 在模拟器中进入「设置」→「Safari」→「高级」，开启「开发者」选项。
  2. 打开Safari，点击顶部的「开发者」菜单，确认未勾选「禁用JavaScript」或「模拟旧版WebKit」等限制选项。
• 重置模拟器状态：在模拟器菜单中选择「Device」→「Erase All Content and Settings」，重置后重新启动模拟器测试。
• 临时polyfill方案：若暂时无法调整模拟器环境，可添加以下代码作为兼容补丁：

if (!crypto?.randomUUID) {
  crypto.randomUUID = () => {
    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, c => {
      const r = Math.random() * 16 | 0;
      const v = c === 'x' ? r : (r & 0x3 | 0x8);
      return v.toString(16);
    });
  };
}

内容的提问来源于stack exchange，提问作者7wp