Cypress.io测试中before钩子被调用两次该如何解决？

触发原因 #

• 核心是Cypress默认的testIsolation（测试隔离）机制：该配置默认开启时，每个包含cy.*命令的测试用例执行前，Cypress都会清空所有页面上下文、Cookie、本地存储，同时重新执行当前测试套件下的所有before钩子，保障每个用例的运行环境独立。无cy.*命令的用例会被判定为同步逻辑，不会触发隔离重置，因此钩子仅执行一次。
• 代码结构问题：before钩子嵌套在it块、子describe块内部，或者同一测试套件内重复定义了多次before钩子，运行时会被重复收集执行。
• 版本bug：v12.0之前的Cypress版本存在钩子执行时序的已知问题，部分场景下会出现非预期的重复调用。
• 强制刷新逻辑：如果before钩子或者前置用例中存在cy.reload()、cy.visit()等页面跳转/刷新逻辑，也会触发钩子二次执行。

修复方案 #

• 关闭指定测试套件的测试隔离：如果同套件内的测试用例允许共享上下文，可以给describe添加配置参数，避免每次用例执行前重置环境：

describe('你的测试套件名称', { testIsolation: false }, () => {
  before(() => {
    // 原有初始化逻辑
  })

  it('测试用例1', () => {
    cy.get('button').click()
  })
})

如果需要全局关闭，可以在cypress.config.js的对应测试类型配置下添加testIsolation: false。

• 全局初始化逻辑迁移：仅需要执行一次的全局初始化操作（如读取固定配置、登录全局测试账号等），迁移到cypress/support/e2e.js（E2E测试）或cypress/support/component.js（组件测试）文件的全局before钩子中，全局钩子只会在所有测试运行前触发一次。
• 校验钩子定义位置：确保所有before钩子都定义在所属describe块的顶层，不要嵌套在其他钩子、it块内部，同时删除重复定义的before钩子。
• 升级Cypress版本：更新到v12.0及以上的稳定版本，修复官方已知的钩子执行逻辑问题。
• 新增执行状态标记：如果不想调整测试隔离配置，可以用全局变量标记钩子执行状态，避免逻辑重复运行：

let isBeforeExecuted = false

describe('你的测试套件名称', () => {
  before(() => {
    if (isBeforeExecuted) return
    // 原有初始化逻辑
    isBeforeExecuted = true
  })

  // 测试用例
})

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