如何实现CypressIO自动化脚本适配多国家站点URL执行测试

1. 先做配置层解耦，彻底消除硬编码URL #

• 把所有站点的差异化参数从测试代码中抽离，单独维护结构化的配置文件，比如新建cypress/config/sites.json，按国家编码存储站点对应的核心信息，示例结构：

{
  "UK": {
    "baseUrl": "https://www.abc.co.uk",
    "enableVatDisplay": true,
    "siteCurrency": "GBP"
  },
  "CH": {
    "baseUrl": "https://www.abc.ch",
    "enableVatDisplay": false,
    "siteCurrency": "CHF"
  },
  "DE": {
    "baseUrl": "https://www.abc.de",
    "enableVatDisplay": true,
    "siteCurrency": "EUR"
  }
}

• 绝对不要在测试用例里写死完整访问链接，所有页面跳转统一用相对路径cy.visit('/')，让目标站点的URL完全由配置层动态注入。
• 支持通过命令行传入站点标识参数，比如启动时加--env targetSite=DE，Cypress初始化时自动匹配配置文件里对应站点的参数，把baseUrl注入全局配置。

2. 用参数化逻辑实现一套脚本跨站点复用 #

• 不要给每个国家站点重复拷贝一套测试代码，把公共测试流程抽成可以接收站点参数的通用函数，通过遍历配置文件的方式循环执行，示例写法：

import siteConfig from '../config/sites.json'

// 封装可复用的公共测试逻辑，入参传入当前站点的配置信息
function runSharedSiteTests(siteMeta) {
  it('首页加载完成后导航栏可见', () => {
    cy.get('nav').should('be.visible')
  })
  it('结算页展示对应站点的结算币种', () => {
    cy.get('.currency-badge').should('contain.text', siteMeta.siteCurrency)
  })
  // 按站点开关条件执行专属功能的验证
  if (siteMeta.enableVatDisplay) {
    it('价格区块展示VAT税费提示', () => {
      cy.get('.vat-note').should('be.visible')
    })
  }
}

// 遍历所有站点配置生成独立的测试套件
Object.entries(siteConfig).forEach(([siteCode, siteMeta]) => {
  describe(`验证${siteCode}站点核心流程`, () => {
    before(() => {
      // 每个测试套件启动前动态切换当前目标站点的baseUrl
      Cypress.config('baseUrl', siteMeta.baseUrl)
    })
    runSharedSiteTests(siteMeta)
  })
})

3. 灵活适配不同执行场景 #

• 全量验证场景：直接启动Cypress执行常规命令即可，配置层会自动遍历所有站点的配置，逐站跑完所有测试，测试报告按站点分组展示结果。
• 单站定向验证场景：比如只改了瑞士站点的功能，不需要全量跑所有站点，就在启动命令里传入对应的站点筛选参数，配置层识别到参数后只加载目标站点的配置执行用例，不用手动改代码。
• 专属功能隔离场景：给不同站点的专属测试用例打对应站点的标签，比如给瑞士站的专属测试打@site:CH标签，CI流水线触发时可以单独筛选执行对应标签的用例，不用每次都全量跑所有站点的测试。

4. 落地时的注意事项 #

• 每个测试套件执行前必须确认当前加载的baseUrl和站点标识匹配，避免因为配置加载顺序问题出现串站测试，导致误报失败。
• 对站点间差异较大的本地化元素（比如多语言按钮、专属营销位），也把对应的选择器、文案存到站点配置文件里，测试时动态读取，不要硬编码到用例里。
• 测试报告里要清晰标记当前用例归属的站点编码，不要把不同站点的测试结果混在一起，方便定位问题。

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