MacOS Sonoma下Electron项目启动报错：Library not loaded: @rpath/Electron Framework

问题分析 #

报错核心是Electron主程序无法找到Electron Framework.framework文件，大概率是包下载不完整、权限限制或版本兼容性问题导致的，以下是针对性的解决步骤：

• 步骤1：重新下载完整的Electron包
  网络波动或pnpm缓存可能导致Electron包下载不完整，执行以下命令清理缓存并重装：

  pnpm store prune
  rm -rf node_modules pnpm-lock.yaml
  pnpm install
  

  若仍有问题，可添加国内镜像加速下载，在项目根目录创建.pnpmrc文件并写入：

  electron_mirror=https://npmmirror.com/mirrors/electron/
  

  再重新执行安装命令。

• 步骤2：修复框架文件权限与签名
  MacOS Sonoma的安全机制可能限制了框架文件的访问权限，进入Electron的框架目录修复权限：

  cd node_modules/.pnpm/electron@28.1.0/node_modules/electron/dist/Electron.app/Contents/Frameworks
  sudo chown -R $(whoami) Electron\ Framework.framework
  sudo chmod -R 755 Electron\ Framework.framework
  

  若权限修复无效，尝试重新签名Electron应用：

  codesign --force --deep --sign - node_modules/.pnpm/electron@28.1.0/node_modules/electron/dist/Electron.app
  

• 步骤3：切换Electron版本
  Electron 28.1.0与MacOS Sonoma可能存在兼容性bug，尝试降级到稳定版或升级至最新版：

  # 降级到27.x稳定版
  pnpm add electron@27.3.2 --save-dev
  # 或升级至最新版
  pnpm add electron@latest --save-dev
  

  安装完成后重新启动项目。

• 步骤4：调整pnpm的依赖隔离模式
  pnpm的严格隔离可能导致路径解析异常，临时禁用隔离模式启动项目：

  PNPM_NO_ISOLATION=1 pnpm run dev
  

  若有效，可在.pnpmrc中添加以下配置永久调整：

  node-linker=hoisted
  

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