Cypress：启动测试时切换目标测试站点的方法

核心思路 #

通过环境变量替代硬编码的访问地址，结合GitHub Actions的手动触发选项，让用户无需修改代码即可选择目标服务器运行测试。

具体实现步骤 #

1. 替换硬编码为环境变量引用

修改测试用例中的cy.visit语句，从Cypress环境变量中读取目标服务器地址：

// 原硬编码代码
// cy.visit('google.com');

// 修改后代码
cy.visit(Cypress.env('TARGET_SERVER'));

2. 配置本地测试的环境变量支持

在项目根目录的cypress.config.js中添加默认环境变量，同时允许命令行覆盖：

const { defineConfig } = require("cypress");

module.exports = defineConfig({
  e2e: {
    env: {
      // 设置默认服务器，方便本地调试
      TARGET_SERVER: 'server1.com'
    },
    // 其他Cypress配置...
  },
});

本地测试时，可通过命令行指定服务器：

# 运行测试并指定服务器2
npx cypress run --env TARGET_SERVER=server2.com

# 打开Cypress界面并指定服务器3
npx cypress open --env TARGET_SERVER=server3.com

3. 配置GitHub Actions实现可视化选择

在项目根目录创建.github/workflows/test.yml，配置支持手动选择服务器的工作流：

name: 多服务器自动化测试
on:
  # 允许手动触发工作流
  workflow_dispatch:
    inputs:
      target_server:
        description: 选择要测试的目标服务器
        required: true
        type: choice
        options:
          - server1.com
          - server2.com
          - server3.com
          - server4.com

jobs:
  run-tests:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4
      
      - name: 安装依赖
        run: npm ci
      
      - name: 运行Cypress测试
        run: npx cypress run --env TARGET_SERVER=${{ github.event.inputs.target_server }}

4. 使用方式

其他用户访问GitHub项目的「Actions」页面，找到上述工作流，点击「Run workflow」，在下拉菜单中选择目标服务器，即可一键触发对应服务器的测试，全程无需修改任何代码。

扩展说明 #

• 若后续新增服务器，仅需修改test.yml中的options列表即可，无需改动测试用例或核心配置。
• 本地测试也支持通过.env文件批量管理环境变量，避免每次输入命令行参数。

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