Electron v11迁移后CI环境安装失败问题求助

问题背景 #

项目从Electron v6迁移至v11后，CI流水线因Electron安装失败异常终止，环境配置为：

• Lerna管理的Monorepo
• Yarn v1.22
• 私有npm registry

出现两类核心错误：

文件冲突错误 #

[4/4] Building fresh packages...
error /builds/xxxx/..../node_modules/electron, /builds/.../node_modules/electron, /builds/xxxx/app/node_modules/electron: Command failed.
Exit code: 1
Command: node install.js
Arguments: 
Directory: /builds/xxxx/features/yyyy/node_modules/electron
Output:
Error: dest already exists.
    at /builds/xxxx/node_modules/fs-extra/lib/move/move.js:41:31

缓存文件丢失错误 #

Exit code: 1
Command: node install.js
Arguments: 
Directory: C:\gitlab\builds\pFMTxHs3\0\xxxxx\features\yyyyy\node_modules\electron
Output:
C:\gitlab\builds\pFMTxHs3\0\xxxx\features\yyyyy\node_modules\electron\install.js:51
  throw err
  ^
[Error: ENOENT: no such file or directory, open 'C:\Users\xxxx\AppData\Local\electron\Cache\httpsgithub.comelectronelectronreleasesdownloadv7.1.4electron-v7.1.4-win32-x64.zip\electron-v7.1.4-win32-x64.zip'] {
  errno: -4058,
  code: 'ENOENT',
  syscall: 'open',
  path: 'C:\\Users\\xxxx\\AppData\\Local\\electron\\Cache\\httpsgithub.comelectronelectronreleasesdownloadv7.1.4electron-v7.1.4-win32-x64.zip\\electron-v7.1.4-win32-x64.zip'

已尝试清理CI缓存、Yarn缓存、NPM缓存，但流水线成功率不稳定，时而成功时而失败。

解决方案 #

1. 统一Monorepo内Electron版本 #

Monorepo多子包依赖不同Electron版本会触发并行安装冲突，在根目录package.json中添加resolutions强制所有子包使用指定v11版本：

"resolutions": {
  "electron": "11.5.0"
}

执行yarn install同步依赖，消除多版本安装竞争。

2. 改用CI本地缓存替代全局缓存 #

全局缓存的跨任务竞争或权限问题会导致ENOENT错误，在CI环境中设置环境变量指定本地缓存路径：

• Linux/macOS CI：

export ELECTRON_CACHE="./.electron-cache"

• Windows CI：

set ELECTRON_CACHE="./.electron-cache"

将.electron-cache/加入.gitignore，并配置CI缓存规则保留此目录，既复用缓存又避免全局冲突。

3. 预清理Electron安装目标目录 #

针对dest already exists错误，在Yarnpostinstall钩子中添加清理逻辑：

1. 在项目根目录创建scripts/electron-install-fix.js：

const fs = require('fs-extra');
const path = require('path');

// 替换为你的子包路径列表
const monorepoPackagePaths = ['features/yyyy', 'app'];

monorepoPackagePaths.forEach(pkgPath => {
  const electronDistDir = path.join(__dirname, '../', pkgPath, 'node_modules/electron/dist');
  if (fs.existsSync(electronDistDir)) {
    fs.removeSync(electronDistDir);
    console.log(`清理冲突目录：${electronDistDir}`);
  }
});

2. 在根目录package.json中添加钩子：

"scripts": {
  "postinstall": "node scripts/electron-install-fix.js"
}

4. 强制串行安装避免资源竞争 #

Yarn v1并行安装会引发多Electron实例写入冲突，在CI安装命令中添加--mutex network参数：

yarn install --mutex network

Lerna环境下可在lerna.json中配置：

"command": {
  "bootstrap": {
    "yarnArgs": "--mutex network"
  }
}

5. 验证私有Registry的Electron镜像配置 #

若私有Registry未代理Electron二进制包，会导致下载异常，在根目录.npmrc中添加镜像配置：

electron_mirror=https://github.com/electron/electron/releases/download/

或替换为你的私有镜像源，确保二进制包可正常下载。

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