如何在GitLab流水线中并行执行带标签的Cypress Cucumber测试用例

原有cypress-tags配置运行失败来自两个可复现的配置错误：

• npm脚本嵌套双引号未做转义，导致npm-run-all（即run-p命令）解析参数时出现字符串截断，无法正确传递执行指令
• cypress-tags run的参数格式错误，-e后多余添加的--分隔符会让Cypress将后续的TAGS识别为独立命令行参数，而非注入的运行环境变量，导致标签筛选逻辑失效

方案1：修正npm脚本适配npm-run-all并行 #

直接修正package.json中的脚本配置，转义嵌套引号、删除多余分隔符即可：

{
  "scripts": {
    "e2e:test": "cypress-tags run -e TAGS='@feature-tag'",
    "test:e2e": "run-p --race \"e2e:test -- {@}\" --"
  }
}

如果需要动态传入标签值适配不同测试场景，不要将标签写死在脚本中，改为读取CI环境变量更灵活：

{
  "scripts": {
    "e2e:test": "cypress-tags run -e TAGS=$CYPRESS_TEST_TAGS",
    "test:e2e": "run-p --race \"e2e:test -- {@}\" --"
  }
}

使用时在GitLab CI的变量配置中设置CYPRESS_TEST_TAGS的值即可，不需要修改脚本代码。

方案2：GitLab CI原生并行（更推荐） #

npm层面的多进程并行会抢占单台Runner的CPU、内存资源，容易提升测试用例的随机失败率，更稳定的方式是直接使用GitLab CI自带的并行能力，搭配Cypress原生并行调度逻辑实现，不需要依赖npm-run-all。
配置步骤如下：

• 将cypress-tags升级到v1.0.2以上版本，修复旧版本与Cypress并行逻辑的兼容问题
• 在.gitlab-ci.yml中配置并行Job：

stages:
  - e2e_test
e2e_parallel:
  stage: e2e_test
  image: cypress/browsers:node-20-chrome-125
  parallel: 4 # 可根据用例总量调整并行节点数量
  script:
    - npm ci
    # 传入标签筛选参数，开启Cypress原生并行，用流水线ID作为同一组并行任务的唯一标识
    - npx cypress-tags run -e TAGS='@feature-tag' --parallel --ci-build-id $CI_PIPELINE_ID
  artifacts:
    when: always
    paths:
      - cypress/screenshots/
      - cypress/videos/
    expire_in: 7 days

该方案下GitLab会自动启动指定数量的独立Job实例，Cypress会自动将标签筛选后的匹配用例拆分到不同节点执行，资源完全隔离，执行稳定性更高。

• 如果使用Windows类型的Runner执行任务，单引号无法被正确识别，需要将标签参数的单引号替换为转义双引号，即写为TAGS=\"@feature-tag\"
• 不要在-e参数后随意添加--分隔符，所有Cypress环境变量配置需要直接跟在-e后，用逗号分隔多个变量

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