如何通过Jenkins流水线重跑Cypress自动化测试失败用例？

AI 小北

2026-8-2

在Jenkins中重跑Cypress失败测试规格/用例的可行方案

方法1：Cypress内置重跑+Jenkins参数化构建

Cypress原生支持指定测试规格文件执行，结合Jenkins参数化构建可以精准重跑失败用例：

给Jenkins任务添加字符串参数，命名为TARGET_SPECS，默认值留空。
修改Cypress执行命令，根据参数分支执行：
- 若TARGET_SPECS为空，执行全量测试：npx cypress run
- 若填入失败的测试规格路径（多个用逗号分隔），则只跑对应文件：npx cypress run --spec "${TARGET_SPECS}"
测试失败后，从Cypress报告（如Mochawesome）里提取失败的.spec.js文件路径，填入参数触发重跑即可。

方法2：导出失败用例列表自动重跑

通过Cypress报告插件生成失败用例清单，用脚本自动提取并执行：

在cypress.config.js中配置失败报告输出：

module.exports = defineConfig({
  e2e: {
    reporter: 'cypress-failed-tests-reporter',
    reporterOptions: {
      filename: 'failed-tests.json'
    }
  }
});

在Jenkins构建脚本中添加逻辑，检测到失败报告后自动重跑：

if [ -f failed-tests.json ]; then
  # 用jq解析JSON，提取测试文件路径并拼接成逗号分隔的字符串
  SPEC_PATHS=$(jq -r '.[] | .file' failed-tests.json | paste -sd "," -)
  npx cypress run --spec "${SPEC_PATHS}"
else
  npx cypress run
fi

首次全量测试失败后，可手动或配置Jenkins自动触发重跑，仅执行失败的测试规格。

方法3：Jenkins插件辅助重跑

安装Cypress Plugin或Test Results Analyzer Plugin，这类插件能解析Cypress生成的JUnit格式报告，自动识别失败的测试用例/规格。
配置完成后，Jenkins构建页面会出现「重跑失败用例」的选项，点击即可直接触发针对性重跑，无需手动整理路径。