如何为Cucumber所有步骤创建Wrapper以统一添加Rescue块

1. 用Around钩子实现全局步骤包裹 #

这是最直接的全局处理方式，Cucumber的Around钩子会拦截每个步骤的执行流程，刚好用来加统一的rescue和前后置处理：

Around do |scenario, block|
  begin
    # 步骤执行前的操作：比如打日志、初始化上下文
    puts "Starting step: #{scenario.current_step.name}"
    block.call # 执行原步骤逻辑
    # 步骤成功后的操作：比如清理资源、记录成功日志
    puts "Step passed: #{scenario.current_step.name}"
  rescue StandardError => e
    # 统一异常处理：打错误日志、保存现场（比如UI截图）
    puts "Step failed: #{scenario.current_step.name} | Error: #{e.message}"
    # 如果是UI自动化，这里可以加截图逻辑
    # page.save_screenshot("failed_step_#{Time.now.to_i}.png")
    raise e # 必须重新抛出，否则Cucumber会误判步骤为成功
  end
end

把这个钩子放在features/support/hooks.rb里，所有步骤都会自动被包裹。

2. 自定义步骤Wrapper方法（灵活适配特定步骤） #

如果需要给不同类型的步骤加差异化处理，可以封装自己的步骤定义方法，替代原生的Given/When/Then：

# 在features/support/step_wrapper.rb里定义
def wrapped_step(keyword, pattern, &block)
  send(keyword, pattern) do |*args|
    begin
      # 前置校验：比如检查参数格式
      puts "Validating args for #{pattern}: #{args}"
      block.call(*args)
      # 后置校验：比如验证操作结果
      puts "Step #{pattern} executed successfully"
    rescue StandardError => e
      puts "Error in step '#{pattern}': #{e.message}"
      # 针对这个步骤的特殊处理：比如重试接口请求
      retry if e.message.include?("timeout") && retry_count < 2
      raise e
    end
  end
end

# 用自定义Wrapper写步骤
wrapped_step :Given, "I have a user with email :email" do |email|
  User.create(email: email)
end

wrapped_step :When, "I submit the login form" do
  click_button "Login"
end

这种方式可以精准控制哪些步骤被包裹，还能给不同步骤加专属的异常处理逻辑。

步骤优化的实用技巧 #

• 参数校验：在Wrapper里对步骤参数做格式检查，比如邮箱格式、数字范围，提前避免无效执行
• 重试机制：对网络请求、UI点击这类不稳定步骤，在rescue块里加重试逻辑（最多2-3次）
• 日志标准化：统一输出步骤名称、参数、执行结果，方便后续日志排查
• 资源自动清理：在步骤成功/失败后统一清理临时数据、关闭浏览器标签页等
• 步骤复用：把重复的操作（比如登录、数据初始化）抽成公共方法，在步骤里调用，减少冗余代码

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