Cypress 测试失败时，afterEach 钩子可能不会执行，导致残留 Cookie/Storage 影响重跑；本文详解通过 testIsolation: true、cy.clearAllCookies() 及前置清理策略，实现故障自恢复的可靠测试初始化。
cypress 测试失败时，`aftereach` 钩子可能不会执行，导致残留 cookie/storage 影响重跑；本文详解通过 `testisolation: true`、`cy.clearallcookies()` 及前置清理策略，实现故障自恢复的可靠测试初始化。
在 Cypress 中，测试用例失败后手动清理浏览器 Cookies 不仅低效，更违背自动化测试的可靠性原则。根本原因在于：afterEach 钩子在测试异常中断（如断言失败、命令超时）时可能完全不执行，导致会话状态（Cookies、localStorage、sessionStorage）残留，进而使下一次 cy.visit() 无法正常加载页面或触发未预期的登录态。
✅ 正确做法是将清理逻辑前置到 beforeEach 的最开始阶段，并配合 Cypress 内置的隔离机制：
1. 启用 testIsolation: true（推荐默认开启）
Cypress v12.0+ 默认启用 testIsolation，它会在每个测试前自动清理所有跨域 Cookies、localStorage 和 sessionStorage。你只需确保配置未显式关闭：
describe('My Test Suite', { testIsolation: true }, () => {
// ✅ 自动隔离：每个测试独享干净上下文
})
⚠️ 注意：若项目中全局设置了 testIsolation: false（例如在 cypress.config.js），请务必改为 true 或移除该配置以启用默认行为。
2. 主动清理 + 断言验证（增强健壮性）
即使启用了 testIsolation，仍建议在 beforeEach 开头显式调用全量清理命令，并用 .should('be.empty') 验证执行完成（因其为异步命令）：
beforeEach(() => {
// ? 强制清除所有域的 Cookies 并等待完成
cy.clearAllCookies()
cy.getAllCookies().should('be.empty')
// ?️ 清除所有 origin 的 localStorage/sessionStorage
cy.clearAllLocalStorage()
cy.getAllLocalStorage().should('be.empty')
cy.clearAllSessionStorage()
cy.getAllSessionStorage().should('be.empty')
// ✅ 此时环境已彻底干净，再执行登录等操作
cy.fixture('login').then((data) => {
cy.login(data.UserName, data.Password)
})
})
3. 移除 afterEach 中的清理逻辑（关键！）
原代码中 afterEach 的 cy.clearCookies() 和 cy.logout() 是风险点——一旦测试在 it() 中崩溃（如元素未找到、网络错误），后续命令将跳过，导致状态残留。清理工作不应依赖“善后”，而应保障“开局即干净”。
✅ 最佳实践总结
- ✅ 始终启用 testIsolation: true（Cypress 默认，无需额外配置）
- ✅ beforeEach 中使用 cy.clearAllCookies() 等全量方法（而非 cy.clearCookies()）
- ✅ 对清理结果做断言（如 .should('be.empty')），确保异步操作完成
- ❌ 避免在 afterEach 中执行关键清理或登出逻辑
- ✅ 登录操作放在清理之后、测试执行之前，保证每次都是全新会话
这样配置后，无论测试成功或失败，下一次运行都将从一个完全干净的浏览器上下文开始，彻底告别手动清 Cookie 的重复劳动。
