Docker容器中运行Cypress测试时环境变量覆盖baseUrl不生效问题

问题根因 #

1. 你同时传入了CYPRESS_BASE_URL和CYPRESS_baseUrl两个大小写不同的同配置环境变量，Cypress 8.x版本存在同名大小写环境变量优先级冲突，会优先读取cypress.json里的默认配置
2. npm执行script时，部分场景下不会自动把前缀匹配的环境变量透传给Cypress子进程，导致配置不生效

解决方案 #

方案一（推荐，无需修改镜像内容）

调整docker run命令，删除重复的小写环境变量，同时显式将baseUrl参数传给启动命令：

docker run \
      --name test \
      --env CI="true" \
      --env CYPRESS_BASE_URL="https://abrakada.com" \
      --network="host" \
      --rm \
      your-image-name \
      npm run cy:integration -- --config baseUrl=$CYPRESS_BASE_URL

方案二（永久生效，修改镜像配置）

修改package.json中的cy:integration脚本，显式指定baseUrl读取环境变量：

{
  "scripts": {
    "cy:integration": "npm run cy:info && cypress run --config baseUrl=$CYPRESS_BASE_URL"
  }
}

方案三（兼容性最高）

将静态的cypress.json改为动态配置文件cypress.config.js，直接读取环境变量作为配置值：

module.exports = {
  baseUrl: process.env.CYPRESS_BASE_URL || "http://localhost:3000",
  chromeWebSecurity: false,
  screenshotOnRunFailure: false,
  videoUploadOnPasses: false
}

修改后重新构建镜像即可，后续启动容器时只要传入CYPRESS_BASE_URL就会自动覆盖默认配置。

验证方法 #

可以在测试用例代码中添加日志输出，确认实际生效的配置：

console.log('当前生效的baseUrl：', Cypress.config('baseUrl'))

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