Cypress中cy.task报错致测试崩溃无法执行后续用例如何解决

cy.task 属于 Cypress 插件层（Node 环境）的异步调用，默认插件层抛出未处理异常会直接中断 Cypress 的测试调度逻辑，哪怕在浏览器层捕获了页面异常，也拦截不到插件层的错误传播，按照以下步骤处理即可解决问题：

1. 插件层统一捕获task异常 #

在 cypress.config.js/ts 中改造所有 task 的实现逻辑，用 try/catch 包裹执行代码，把错误信息转为返回值的一部分，禁止直接抛出异常中断 Node 进程：

// cypress.config.js 示例
const { defineConfig } = require("cypress");

module.exports = defineConfig({
  e2e: {
    setupNodeEvents(on, config) {
      on('task', {
        // 替换为你自己的task名称
        yourCustomTask(params) {
          try {
            // 原有业务执行逻辑
            const result = handleYourOperation(params)
            return { success: true, data: result }
          } catch (err) {
            // 捕获异常后返回错误标识，不直接抛错
            return { success: false, errorMsg: err.message, errorStack: err.stack }
          }
        }
      })
    },
  },
});

2. 测试用例层按返回值判断执行结果 #

调用 cy.task 后校验返回值，用断言明确标记用例失败，不会触发全局异常中断后续测试：

it('测试用例1', () => {
  cy.task('yourCustomTask', testParams).then(res => {
    // task执行失败时主动断言失败，错误信息会展示在测试报告中，不会中断后续用例
    expect(res.success, `task执行失败：${res.errorMsg}`).to.be.true
    // 后续正常执行其他测试逻辑
  })
})

it('测试用例2', () => {
  // 上一个用例失败后当前用例可正常执行
})

3. 全局兜底异常处理 #

• 插件层兜底：在 setupNodeEvents 中监听 Node 进程未捕获异常，避免进程崩溃导致测试调度卡死

// setupNodeEvents 函数内添加
setupNodeEvents(on, config) {
  process.on('uncaughtException', (err) => {
    console.error('插件层未捕获异常：', err.message)
  })
  // 其他task配置
}

• 浏览器层兜底：在 cypress/support/e2e.js 中添加全局异常拦截，阻止异常向上传播导致测试中断

Cypress.on('uncaught:exception', (err) => {
  // 匹配task相关异常，返回false阻止Cypress中断测试
  if (err.message.includes('task')) return false
  return true
})

注意：不要在task实现逻辑中直接抛出未捕获的错误，这是导致测试调度卡死的核心原因，所有异常都必须在插件层转为返回值或者被兜底捕获。

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