MacOS Big Sur下Electron运行报GPU process isn't usable错误如何解决

开发阶段无合规风险的临时修复 #

不需要全局禁用沙箱，仅添加GPU适配参数即可解决开发环境启动报错：
在main.js的app ready事件触发前添加如下代码：

// 仅适配MacOS Big Sur开发环境的GPU兼容配置，不影响构建后的沙箱合规性
if (process.platform === 'darwin' && process.env.NODE_ENV === 'development') {
  app.commandLine.appendSwitch('disable-gpu-sandbox')
}

如果仍有报错，可以追加app.commandLine.appendSwitch('disable-gpu')参数，该配置仅在开发环境生效，构建生产包时可自动排除，不会违反App Store的沙箱合规要求。

旧用户环境问题排查步骤 #

已经确认新用户环境运行正常，按优先级从高到低排查旧用户配置：

• 清除Electron全局缓存：删除~/Library/Caches/electron、~/Library/Application Support/Electron两个目录，执行npm ci重新安装项目依赖后测试
• 检查用户自定义环境变量：依次查看~/.zshrc、~/.bash_profile、~/.profile等shell配置文件，寻找是否有ICU_DATA、CHROMIUM_*、ELECTRON_*前缀的自定义全局变量，如有则临时注释，重启终端后再运行应用
• 排查第三方软件冲突：临时退出所有代理工具、设备管控软件、杀毒软件、系统优化类工具后重新测试，这类软件通常会注入系统进程拦截子资源访问，是导致Electron子进程读取icudtl.dat失败的常见原因
• 修复用户目录权限：执行终端命令sudo chown -R $(whoami) ~修复当前用户目录的所有权，排除因文件权限异常导致的资源读取失败
• 重置隐私权限配置：打开「系统偏好设置-安全性与隐私-隐私」，确认终端/代码编辑器已经授予「完全磁盘访问权限」，也可以移除权限后重新添加授权

生产构建合规方案 #

• 升级Electron到13.x及以上的LTS版本，早期Electron版本存在Big Sur系统沙箱适配的已知缺陷
• 配置plist权限时除了开启com.apple.security.app-sandbox，需要根据应用实际功能补全必要的权限声明，缺省会导致沙箱进程启动失败
• 构建完成后依次执行codesign -dv --verbose=4 应用包路径.app和spctl --assess --verbose=4 应用包路径.app验证签名和沙箱合规性，提前排查配置错误

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