PAYATHON 2026

Lighthouse CI 连续运行第二次测试时出现 EPERM 错误,如何解决?

数据小许

优先检查 chrome-launcher 的临时目录清理问题

这个错误发生在删除临时目录时。先检查 Lighthouse CI 实际使用的 chrome-launcher 版本。上游在 v1.2.2 中修复了 Windows 进程退出阶段的 EPERM 问题,涉及 destroyTmp() 的重试延迟和错误处理。v1.2.2 发布说明

现有堆栈只显示了 rmSync,还不能确认是否是同一个缺陷。如果完整堆栈中同时出现 Launcher.destroyTmp 和 Launcher.kill,就更符合这一问题的特征。

为什么 execSync 和更换目录没有解决

Chrome 退出和临时目录清理之间可能存在时序问题:开始删除时,目录中的文件仍被进程占用。上游问题记录中有相同的 Windows 错误及相关排查结果。相关问题记录

execSync 会等待它启动的命令结束,但无法改变命令内部关闭 Chrome 和删除目录的顺序。即使外层调用已经串行执行,内部清理仍可能失败。

--user-data-dir=./tmp 指定的是 Chrome 用户数据目录,不能保证修复 launcher 自己管理的临时目录清理流程。如果报错路径仍指向 Temp\lighthouse.*,说明失败的删除操作仍针对该临时目录。

先确认实际运行的依赖,再更新

在项目目录中检查版本:

node --version
npm ls @lhci/cli lighthouse chrome-launcher

如果运行的是全局安装的 lhci,还需要检查全局依赖:

npm ls -g @lhci/cli lighthouse chrome-launcher

对于项目本地安装,可以先尝试在现有依赖约束内更新:

npm update chrome-launcher
npm ls chrome-launcher

要确认 LHCI 所在依赖链实际使用了包含修复的版本。在项目根目录单独安装新版 chrome-launcher,不一定会替换嵌套依赖中的旧副本。

如果依赖约束阻止更新,优先升级到与当前 Node 环境兼容的 @lhci/cli 版本。若暂时无法升级,并确认 chrome-launcher 只是间接依赖,也可以在支持 overrides 的 npm 中尝试定向覆盖。将以下字段合并到根目录的 package.json:

{
  "overrides": {
    "chrome-launcher": "1.2.2"
  }
}

然后重新安装并检查:

npm install
npm ls @lhci/cli lighthouse chrome-launcher
npx lhci autorun

overrides 会改变依赖解析结果,使用前需要确认调用方兼容。如果 chrome-launcher 本身也是直接依赖,还需要遵守 npm 对直接依赖覆盖的限制。npm overrides 文档

配置中需要注意什么

原配置中的 numberOfRuns: 1 表示每个 URL 运行一次。配置了两个 URL,仍会执行两次采集,因此这个设置无法避开连续运行的问题。LHCI collect 配置说明

如果继续验证 chromeFlags,应把它放在 ci.collect.settings 下:

settings: {
  onlyCategories: ["performance"],
  chromeFlags: "--user-data-dir=./tmp"
}

这段代码只说明参数位置,不能视为该 EPERM 错误的修复。原问题没有展示尝试该参数时的完整配置,也就不能断定之前放错了位置。LHCI Chrome Flags 配置示例

更新后仍然失败时如何排查

保留完整堆栈,确认失败是否仍来自 chrome-launcher 的清理流程。停止当前测试后,检查对应的 Chrome 进程是否残留,再尝试删除报错中指定的目录。

如果进程完全退出后仍无法删除,检查运行账户对该目录的权限,以及是否有其他进程占用文件。只处理此次测试创建的目录和进程,避免影响正在使用的 Chrome 会话。

复测时保留原来的两个 URL,检查命令退出码和 ./reports 中的报告。修复版本增加了清理失败时的错误处理,因此还应留意日志中的清理警告和残留目录,不能只看命令是否退出成功。上游修复说明

备注:内容仅供参考。