如何避免Cypress未找到匹配测试文件时运行失败退出？

以下是3种可落地的实现方案，你可以根据自己的项目情况选择：

方案1：前置校验脚本（推荐，性能最优） #

在执行Cypress命令前新增预检查逻辑，复用你现有的git diff和正则过滤规则，提前判断是否存在需要运行的测试用例，没有的话直接跳过Cypress执行流程，不会触发错误。

• 新增预检查脚本pre-check-cy-specs.js：

// 复用你现有过滤逻辑，计算待执行的spec列表
const yourFilterLogic = require('./你的自定义过滤库路径')

async function checkSpecs() {
  const targetSpecs = await yourFilterLogic.getMatchSpecs()
  if (targetSpecs.length === 0) {
    console.log('本次修改无关联Cypress测试用例，跳过测试执行')
    process.exit(0)
  }
}

checkSpecs()

• 修改package.json中的运行脚本：

{
  "scripts": {
    "test:cy:run:functional": "node pre-check-cy-specs.js && cypress run --headless"
  }
}

方案2：Cypress钩子内置处理（改造成本最低） #

直接在Cypress配置文件的before:run钩子中判断待执行用例数量，如果为空直接正常退出，不会返回错误码。
修改你的Cypress配置文件（新版本为cypress.config.js，旧版本为cypress/plugins/index.js）：

const { defineConfig } = require('cypress')

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      // 你的现有过滤逻辑保留
      // 新增before:run钩子
      on('before:run', async (runDetails) => {
        if (runDetails.specs.length === 0) {
          console.log('未匹配到任何Cypress测试用例，跳过执行')
          process.exit(0)
        }
      })
    }
  }
})

方案3：命令行错误捕获（无需修改JS逻辑） #

如果你不想改动现有JS代码，可以直接修改package.json的运行脚本，对Cypress的报错进行判断，只有当错误原因为「无匹配用例」时返回成功状态：

{
  "scripts": {
    "test:cy:run:functional": "cypress run --headless 2>&1 | tee cy-run.tmp.log || (grep -q \"Can't run because no spec files were found\" cy-run.tmp.log && rm cy-run.tmp.log && exit 0 || rm cy-run.tmp.log && exit 1)"
  }
}

注意：该方案依赖shell环境的tee和grep命令，Windows环境需要适配对应的命令行语法。

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