Cypress-Jenkins问题：npm运行脚本设置的环境变量无法在Cypress文件读取

问题核心 #

本地通过package.json脚本"cy:run:tst":"cypress run --env ENV=staging"能正常获取环境变量，但Jenkins中运行失败，大概率不是方向错误，而是Jenkins执行上下文、变量传递方式或Cypress变量获取逻辑存在偏差。

可行解决方法 #

1. 确保Jenkins脚本执行上下文正确 #

Jenkins流水线中必须先切换到项目根目录（包含package.json的路径），再执行npm命令，避免路径错误导致脚本无法解析。示例Groovy代码：

stage('Run Cypress Tests') {
    steps {
        sh 'cd /your/project/root/path && npm install'
        sh 'cd /your/project/root/path && npm run cy:run:tst'
    }
}

同时检查Jenkins节点的Node.js版本与本地一致，版本差异可能导致参数解析异常。

2. 直接在Jenkins流水线中传递变量 #

跳过package.json脚本的间接传递，在Groovy中直接定义变量并传入Cypress命令，确保变量明确传递：

stage('Run Cypress Tests') {
    environment {
        TEST_ENV = 'staging' // 可根据构建参数动态设置
    }
    steps {
        sh 'cypress run --env ENV=${TEST_ENV}'
    }
}

3. 修正测试文件中变量的获取方式 #

注意cypress run --env设置的是Cypress内部环境变量，而非Node进程环境变量，测试文件中必须用Cypress提供的方法获取：

// 正确写法
const targetUrl = Cypress.env('ENV') === 'staging' 
    ? 'https://staging.yourdomain.com' 
    : 'https://prod.yourdomain.com';

// 错误写法（无法获取--env参数）
// const targetUrl = process.env.ENV === 'staging' ? ...

4. 验证变量传递是否生效 #

在Jenkins步骤中添加调试命令，确认变量是否被正确传递到Cypress：

sh 'cypress env --env ENV=staging'

执行后查看输出，如果显示ENV: staging，说明传递成功，问题出在测试文件的逻辑；如果没有，检查Jenkins的命令执行权限或参数解析问题。

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