Cypress测试失败后如何执行指定清理测试？

核心思路 #

Cypress 默认在测试失败后会中断后续执行，但可以通过配置和自定义钩子确保清理逻辑无论测试成功/失败都能执行。

可行方案 #

1. 全局事件监听确保清理 #

在项目的 cypress/support/e2e.js（或对应支持文件）中添加全局监听，捕获每个测试的运行状态，只要有创建的用户ID就执行删除：

// 全局存储创建的用户ID
let createdUserIds = [];

// 创建用户后将ID存入数组
cy.createTestUser().then(userId => {
  createdUserIds.push(userId);
});

// 监听所有测试结束事件
Cypress.on('test:after:run', (test, runnable) => {
  if (createdUserIds.length > 0) {
    createdUserIds.forEach(userId => {
      cy.request('DELETE', `/api/users/${userId}`);
    });
    createdUserIds = []; // 清空避免重复删除
  }
});

2. 修复 after 钩子失效问题 #

如果你的 after 钩子未触发，可结合命令链强制执行清理逻辑：

describe('用户管理测试', () => {
  let userId;

  before(() => {
    cy.createTestUser().then(id => {
      userId = id;
    });
  });

  // 强制执行清理，不受测试失败影响
  after(() => {
    if (userId) {
      cy.wrap(null).then(() => {
        deleteCreatedUsers(userId); // 调用你的删除函数
      });
    }
  });

  it('测试用户功能', () => {
    // 测试逻辑，即使此处失败，after钩子仍会执行
    cy.visit('/users');
    cy.get(`#user-${userId}`).should('exist');
  });
});

注意：删除逻辑要基于Cypress命令链，避免使用原生异步Promise导致钩子提前结束。

3. 禁用快速失败（应急方案） #

在 cypress.config.js 中关闭测试失败后中断的行为，让清理测试能正常运行：

module.exports = defineConfig({
  e2e: {
    failFast: false, // 禁用快速失败，前面测试失败后后续测试仍会执行
  },
});

缺点：会增加整体测试时长，仅适合小规模测试套件。

关键注意事项 #

• 清理逻辑要独立于测试流程，不依赖测试中可能失败的步骤；
• 存储用户ID可使用全局变量或Cypress环境变量（Cypress.env('createdUserId', userId)），确保跨钩子可访问；
• 优先使用全局事件监听，无需为每个测试套件重复编写清理代码。

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