Github Action中Cypress偶现测试结果未找到错误求助

可能的原因 #

1. 脚本嵌套启动导致进程同步异常
   你的配置存在两层启动嵌套：cypress-io/github-action通过start参数调用npm run test:e2e:ci，而该脚本又通过start-server-and-test启动预览服务并执行cypress run。这种嵌套结构会让GitHub Action无法精准追踪Cypress进程的结束时机，偶尔会在Cypress还未生成测试结果文件时就尝试读取，从而抛出「找不到测试结果」的错误。

2. Cypress v11.x的CI兼容性Bug
   Cypress v11.0.1属于较旧版本，存在一些CI环境下的文件同步、进程退出检测偶发问题，可能导致测试完成后结果文件生成延迟或不完整。

3. 服务启动与测试执行的时序偏差
   在GitHub Actions的共享runner环境中，即使start-server-and-test会等待端口就绪，偶尔也会出现服务进程未完全初始化就启动测试的情况。虽然测试本身能通过，但可能触发Cypress结果文件生成异常。

解决办法 #

1. 重构配置，消除嵌套启动 #

修改npm脚本和GitHub Action配置，让cypress-io/github-action直接管理服务启动与测试执行，去掉start-server-and-test的嵌套：

• package.json脚本修改：

  "scripts": {
    "build": "vue-tsc && vite build",
    "preview": "vite preview",
    "test:e2e:ci": "cypress run --e2e"
  }
  

• GitHub Action配置修改：

  - name: Check if e2e tests are passing
    uses: cypress-io/github-action@v4
    with:
      build: npm run build
      start: npm run preview
      wait-on: 'http://localhost:4173'
      wait-on-timeout: 120
      command: npm run test:e2e:ci
  

  此配置下，action会先启动预览服务，确认端口就绪后再执行Cypress测试，直接追踪测试进程状态，避免嵌套导致的同步问题。

2. 升级Cypress到稳定版本 #

Cypress v11.x后续版本及v12+修复了大量CI相关bug，建议升级到最新稳定版：

npm install cypress@latest --save-dev

3. 明确指定Cypress结果目录 #

在cypress.config.ts中显式配置测试结果输出目录，确保GitHub Action能准确定位：

import { defineConfig } from 'cypress'

export default defineConfig({
  e2e: {
    // 其他配置...
    reporter: 'junit',
    reporterOptions: {
      resultsDir: 'cypress/results'
    }
  }
})

4. 增加结果文件等待逻辑（可选） #

若上述方法仍偶发问题，可在测试步骤后添加等待逻辑，确保结果文件生成：

- name: Check if e2e tests are passing
  uses: cypress-io/github-action@v4
  with:
    build: npm run build
    start: npm run preview
    wait-on: 'http://localhost:4173'
    command: npm run test:e2e:ci
- name: Wait for test results
  run: |
    until [ -f cypress/results/junit.xml ]; do
      sleep 2
    done
    echo "Test results found"

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