如何在Cucumber中实现失败场景或步骤的程序化重执行？

首先直接给答案：当然可以实现，但Cucumber本身没有内置的一键重复API，得通过一些变通手段来搞定，下面分两种场景给你具体方案：

一、重复执行完整失败场景 #

这个相对简单，有两种常见方式：

1. 通过CLI命令调用（最容易实现） #

你可以利用Node.js的child_process模块，在After钩子中执行和命令行cucumber ./features/test.feature:4一样的指令，启动一个新的Cucumber进程来重复运行失败的场景。

代码示例：

const { After } = require('cucumber');
const { execSync } = require('child_process');

// 限制重复次数，避免无限循环
const MAX_RETRY = 1;

After((env) => {
  if (env.status === 'failed' && env.scenario.retryCount === undefined) {
    env.scenario.retryCount = 1;
    const scenarioLine = env.scenario.line;
    const featurePath = env.scenario.uri;
    
    console.log(`🔄 Retrying failed scenario: ${featurePath}:${scenarioLine} (Attempt ${env.scenario.retryCount}/${MAX_RETRY})`);
    try {
      // 同步执行CLI命令，把输出同步到当前终端
      execSync(`cucumber ${featurePath}:${scenarioLine}`, { stdio: 'inherit' });
    } catch (err) {
      console.error(`❌ Retry failed for scenario: ${featurePath}:${scenarioLine}`, err.message);
      if (env.scenario.retryCount < MAX_RETRY) {
        env.scenario.retryCount++;
        // 可根据需求调整为异步重试逻辑，避免阻塞当前进程
      }
    }
  }
});

注意事项：

• 这种方式是启动独立进程，测试的上下文（比如浏览器实例、数据库连接）不会和原进程共享，你的测试需要保证可以独立初始化环境。
• 一定要加重试次数限制，不然失败场景会无限重复执行。

2. 使用Cucumber编程式API（复杂但进程内执行） #

如果你不想启动新进程，可以用Cucumber的编程式API手动构建运行器来执行场景。不过这个方式需要深入了解Cucumber的内部机制，比如加载配置、定位场景、管理执行上下文。大概思路是：

• 加载Cucumber配置文件
• 创建Runtime实例
• 根据env.scenario的信息找到对应的Feature和Scenario
• 触发执行逻辑

这种方式复杂度较高，适合有一定Cucumber源码了解的开发者，这里就不贴具体代码了，核心是利用Cucumber暴露的编程接口来实现内部执行。

二、重复执行单个失败步骤 #

这个难度更高，因为单个步骤依赖整个场景的上下文（比如World对象、之前步骤设置的变量），不过也有可行的思路：

核心思路：手动调用步骤定义函数 #

你可以跟踪失败的步骤，找到对应的步骤定义，然后在当前上下文里重新调用它。

代码示例（简化版）：

const { After, defineStep } = require('cucumber');

// 自定义步骤注册函数，用来保存所有步骤定义
const stepDefinitions = new Map();
function registerStep(pattern, handler) {
  defineStep(pattern, handler);
  // 把正则表达式和处理函数关联起来
  stepDefinitions.set(new RegExp(pattern), handler);
}

// 示例步骤定义（用我们的自定义注册函数）
registerStep('I login with username {string} and password {string}', async function (username, password) {
  // 你的登录逻辑
});

After(async (env) => {
  if (env.status === 'failed') {
    // 找到第一个失败的步骤
    const failedStep = env.scenario.steps.find(step => step.status === 'failed');
    if (!failedStep) return;

    console.log(`🔄 Retrying failed step: ${failedStep.name}`);
    // 匹配对应的步骤定义
    for (const [patternRegex, handler] of stepDefinitions.entries()) {
      const matches = failedStep.name.match(patternRegex);
      if (matches) {
        try {
          // 用当前World对象作为上下文，调用步骤处理函数
          await handler.call(env.world, ...matches.slice(1));
          console.log(`✅ Step retried successfully`);
        } catch (err) {
          console.error(`❌ Step retry failed: ${err.message}`);
        }
        break;
      }
    }
  }
});

注意事项：

• 步骤的正则匹配可能会有误差，尤其是复杂的步骤表达式，需要仔细处理。
• 异步步骤一定要用await等待执行完成。
• 上下文依赖问题：如果失败步骤依赖之前步骤设置的变量，需要确保这些变量在当前World对象中仍然有效，没有被清理。
• Cucumber的内部API可能会更新，这种依赖步骤定义跟踪的方式可能在版本升级后失效。

总结 #

• 重复场景用CLI调用的方式最省心，适合大多数场景。
• 重复单个步骤适合特殊需求，但需要处理很多上下文和匹配的细节，稳定性稍差。

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