GitLab CI无法识别Cypress变量问题求助

1. 修正.gitlab-ci.yml的变量定义 #

你当前的variables块写法完全错误，会导致变量无法正确引用项目CI/CD设置中的值：

• 初始配置里的CYPRESS_BASE_URL: "$CYPRESS_BASE_URL"属于循环引用，等于把变量值设为自身的初始空值
• 修改后的CYPRESS_BASE_URL: "CYPRESS_BASE_URL"是把变量值设为字符串字面量，根本没读取项目里的CI变量

正确做法：直接移除variables块，项目CI/CD设置中配置的变量会自动注入到CI运行环境中。如果需要设置默认值，才需要在variables块里定义，示例：

stages:
  - test

test:
  image: cypress/browsers:node18.12.0-chrome107
  stage: test
  script:
    - npm ci
    - printenv | grep CYPRESS  # 先验证变量是否存在
    - npm run chrome
    - echo "The URL is '$CYPRESS_BASE_URL'"

2. 修正Cypress代码的变量读取逻辑 #

Cypress会自动将前缀为CYPRESS_的环境变量映射为不带前缀的Cypress.env()键值，你的代码写法有误：

• 错误写法：Cypress.env("CYPRESS_BASE_URL")
• 正确写法：Cypress.env("BASE_URL")

修正后的测试代码：

const baseUrl = Cypress.env("BASE_URL");
const user = Cypress.env("USER");
const password = Cypress.env("PASSWORD");

describe('Login and Sort', () => {
  beforeEach(() => {
    cy.visit(baseUrl);
    cy.login(user, password);
  });
});

3. 检查CI变量的可见性设置 #

登录GitLab项目，进入Settings > CI/CD > Variables，检查你配置的变量：

• 如果变量开启了Protected，只有在受保护分支/标签上运行CI时才能访问，若你在普通分支测试，需要取消保护，或者把分支设为受保护
• 如果变量开启了Masked，echo时会显示为********，但实际环境变量是存在的，不影响Cypress使用

4. 验证环境变量是否成功注入 #

在CI脚本里添加printenv | grep CYPRESS命令，查看所有CYPRESS_前缀的变量是否存在。如果输出为空，说明项目CI/CD变量没有正确注入，需要检查：

• 变量名称是否完全匹配（区分大小写）
• 变量是否属于当前项目（而非群组变量，若用群组变量需确保项目有权限继承）

5. 确认npm脚本的正确性 #

检查package.json中的chrome脚本，确保它正确调用Cypress，没有覆盖环境变量：

{
  "scripts": {
    "chrome": "cypress run --browser chrome"
  }
}

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