Cypress测试中after()仅在用例成功时触发该如何解决？

问题原因 #

Cypress 官方设计的 after() 钩子本身默认就是无论测试用例成功或失败都会执行的，你遇到钩子不触发的情况，大概率是以下两种原因：

• 你的 Cypress 配置（cypress.config.js/ts）中开启了 stopOnFirstFail: true 或者 stopOnSpecFailure: true，只要有测试用例失败就直接终止整个测试运行流程，after() 钩子还没来得及触发就结束了。
• 你使用的是低于 7.x 的老旧 Cypress 版本，旧版本存在部分场景下钩子执行异常的已知问题。

解决方案 #

你可以按以下步骤排查修复：

1. 调整核心配置 #

首先在 cypress.config.js 中确认以下配置项：

const { defineConfig } = require('cypress')

module.exports = defineConfig({
  e2e: {
    // 关闭失败即停逻辑，确保单个用例失败后还会跑完后续钩子和其他测试
    stopOnFirstFail: false,
    stopOnSpecFailure: false,
    // 如果不需要每个用例都自动重置页面，可关闭testIsolation（可选）
    testIsolation: false
  }
})

如果是页面X本身的未捕获JS异常导致测试提前中断，可以在测试块开头添加代码忽略页面异常，保证流程继续：

Cypress.on('uncaught:exception', (err, runnable) => {
  return false
})

2. 用afterEach替代after做清理 #

如果你的清理逻辑是针对当前describe块的测试用例，把after()替换为afterEach()会更稳妥，它会在每一个it用例执行完成后（无论成功失败）立刻触发：

describe('Test Page X', function () {
    before(function () {
      cy.navigateTo('page-x', 0)
    })
    it ('should work', function(){
      cy.doSomething()
    })
    afterEach(function(){
      cy.navigateBack()
    })
  })

3. 兜底全局监听方案 #

如果以上修改还是不生效，可以在全局做事件监听兜底，在cypress/support/e2e.js里添加以下代码：

// 每个测试用例结束后都会触发，不受用例成功失败影响
Cypress.on('test:after:run', (test, runnable) => {
  // 可按需添加判断条件，只在指定测试块执行清理逻辑
  if (runnable.parent.title === 'Test Page X') {
    cy.navigateBack()
  }
})

注意：如果你的navigateBack()逻辑本身存在执行错误，会抛出新的异常导致看起来清理没生效，可以临时在清理逻辑相关命令后加{ failOnStatusCode: false }等配置关闭错误校验，先确认是不是清理代码本身的问题。

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