GitHub Action执行Cypress并行测试后缺失JSON报告求助

1. 核心原因分析 #

你遇到的问题主要来自三个层面：

• cypress-split与cypress-mochawesome-reporter的配置不兼容，导致分片报告生成/合并逻辑出错
• GitHub Actions环境中，测试执行后的临时报告文件被自动清理或路径解析错误
• 未显式触发报告合并步骤，导致cypress-split无法找到完整的测试结果

2. 分步解决方法 #

（1）修正cypress.config.ts配置 #

确保cypress-split与reporter的路径、并行逻辑兼容，关键是开启分片报告不覆盖模式：

import { defineConfig } from 'cypress';
import mochawesomeReporter from 'cypress-mochawesome-reporter';

export default defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      mochawesomeReporter(on);
      // 初始化cypress-split
      require('cypress-split')(on, config);
      
      config.reporterOptions = {
        reportDir: `${process.cwd()}/cypress/reports/html`, // 用绝对路径避免解析错误
        overwrite: false, // 禁止覆盖分片报告，否则合并时会丢失数据
        html: false, // 先只生成JSON，最后统一合并
        json: true,
        charts: true
      };
      return config;
    },
  },
});

（2）保留报告文件避免被清理 #

GitHub Actions的job/step默认会隔离工作目录，且部分环境会自动清理临时文件，需要手动保留报告：

• 在测试步骤前手动创建报告目录，确保权限：

steps:
  - name: Create report directories
    run: mkdir -p cypress/reports/html/.jsons

• 如果是多job并行测试，需用actions/upload-artifact在每个测试job上传分片报告，再在合并job下载汇总：

# 测试job中添加
- name: Upload split reports
  uses: actions/upload-artifact@v4
  with:
    name: cypress-split-reports
    path: cypress/reports/html/.jsons/*.json

（3）显式触发报告合并 #

cypress-mochawesome-reporter不会自动合并分片报告，必须手动执行合并命令：

1. 在package.json中添加合并脚本：

{
  "scripts": {
    "cypress:run": "cypress run",
    "cypress:merge": "mochawesome-merge cypress/reports/html/.jsons/*.json > cypress/reports/html/merged.json",
    "cypress:generate-report": "marge cypress/reports/html/merged.json -o cypress/reports/html"
  }
}

2. 在GitHub工作流中，测试完成后执行合并：

steps:
  # ... checkout、安装依赖、安装Cypress、运行测试步骤
  - name: Merge test reports
    run: npm run cypress:merge
  - name: Generate final HTML report
    run: npm run cypress:generate-report

（4）解决"Could not find spec results"提示 #

这个错误是因为cypress-split找不到对应分片的结果文件，需确保：

• 测试运行时传递--env split=true参数，开启分片模式：

- name: Run split tests
  run: npm run cypress:run -- --env split=true

• 合并步骤必须在测试完成后立即执行，且报告路径完全匹配配置中的绝对路径

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