Lighthouse在GitHub Actions中无文件输出问题求助

1. 明确报告输出路径配置 #

默认lhci autorun会将报告生成在项目根目录的.lighthouseci文件夹，但GitHub Actions的工作环境可能和本地存在差异。可以显式指定输出目录，确保路径可追踪：

lhci autorun --collect.outputDir=./lh-reports

后续步骤可直接引用./lh-reports目录来确认报告是否存在。

2. 核对GitHub Actions工作目录 #

如果你的项目有子目录结构（比如monorepo），需在Action步骤中指定正确的工作目录，避免命令执行路径错误：

- name: 运行Lighthouse CI
  working-directory: ./your-react-project-dir
  run: lhci autorun

3. 检查是否存在清理步骤误删报告 #

若Action流程中有缓存清理、构建后清理等步骤，可能会意外删除生成的报告目录。可在报告生成后添加一个目录检查步骤，确认文件存在：

- name: 查看报告目录文件
  run: ls -la ./lh-reports

4. 改用项目本地依赖安装CLI #

全局安装的CLI在GitHub Actions环境中可能存在路径未加入环境变量的问题，建议将@lhci/cli安装为项目本地依赖：

npm install @lhci/cli@0.9.x --save-dev

然后通过本地依赖执行命令：

- name: 运行Lighthouse CI
  run: npx lhci autorun

5. 确保项目构建步骤已完成 #

Lighthouse需要访问已构建的静态产物，若执行lhci autorun前未完成项目构建，可能导致报告生成异常（日志显示生成但目录为空）。需在Action中先执行构建：

- name: 构建项目
  run: npm run build

内容的提问来源于stack exchange，提问作者Maifee Ul Asad