如何解决GitLab中环境变量运行指定Cypress测试的流水线报错？

1. 优先修复.gitlab-ci.yml语法错误 #

你提供的.gitlab-ci.yml片段存在语法问题：

- TEST_FILTER: sampleTest.feature

这种列表项格式的变量定义不符合GitLab CI规范，环境变量必须放在variables块中（全局或指定job级别）。

正确写法示例： #

• 全局变量（所有流水线job生效）：

variables:
  TEST_FILTER: "sampleTest.feature"

• 单个job变量（仅对指定测试job生效）：

cypress_test_job:
  script:
    - npm run cy:run  # 替换为你实际运行Cypress的命令
  variables:
    TEST_FILTER: "sampleTest.feature"

2. 确认环境变量与Cypress的匹配逻辑 #

你在index.js中用Cypress.env('TEST_FILTER')读取变量，因此GitLab中设置的变量名需保持为TEST_FILTER（无需加CYPRESS_前缀，Cypress可直接读取该变量）。

如果想沿用package.json里CYPRESS_TEST_FILTER的命名，只需把GitLab中的变量名改为CYPRESS_TEST_FILTER，index.js代码无需修改——Cypress会自动识别以CYPRESS_开头的环境变量并注入到Cypress.env()中。

3. 验证CI配置语法 #

GitLab流水线的"Undefined error"大多由配置文件语法错误导致，建议使用项目内的CI Lint工具（路径：CI/CD -> CI Lint）粘贴完整的.gitlab-ci.yml内容，快速定位语法问题。

4. 补充：多测试用例过滤优化 #

如果需要支持多测试列表（如"Test1, Test2"），可修改index.js的过滤逻辑：

beforeEach(function() {
  const testFilter = Cypress.env('TEST_FILTER');
  if (!testFilter) return;

  const testName = Cypress.mocha.getRunner().test.fullTitle();
  const targetTests = testFilter.split(',').map(item => item.trim());
  
  if (!targetTests.some(test => testName.includes(test))) {
    this.skip();
  }
})

修改后在GitLab中设置TEST_FILTER: "Test1, Test2"即可同时过滤多个测试用例。

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