Rails5/RSpec系统测试：如何配置selenium-webdriver截图文件名格式

刚好我之前处理过类似的需求，不用依赖capybara-screenshot gem，直接通过RSpec的配置就能自定义Selenium截图的文件名，具体实现如下：

核心思路 #

默认情况下，RSpec系统测试会用测试用例的完整描述作为截图文件名，一旦描述过长就会触发保存失败。我们可以通过自定义RSpec的after钩子，覆盖默认的截图逻辑，生成简洁且唯一的文件名。

具体实现步骤 #

1. 创建自定义截图配置文件
   在spec/support目录下新建system_test_screenshots.rb文件，添加以下代码：

RSpec.configure do |config|
  config.after(:example, type: :system) do |example|
    # 仅在测试失败时生成截图
    next unless example.exception

    # 生成简洁唯一的文件名：RSpec测试用例ID + 时间戳
    screenshot_name = "screenshot_#{example.id}_#{Time.now.strftime('%Y%m%d_%H%M%S')}.png"
    # 截图保存到tmp/screenshots目录（可根据需求修改路径）
    screenshot_path = Rails.root.join('tmp', 'screenshots', screenshot_name)

    # 确保保存目录存在，避免触发目录不存在的报错
    FileUtils.mkdir_p(Rails.root.join('tmp', 'screenshots'))

    # 调用Capybara截图方法（底层由selenium-webdriver执行）
    page.save_screenshot(screenshot_path)
    puts "测试失败，截图已保存至：#{screenshot_path}"
  end
end

2. 确保配置文件被加载
   打开spec/rails_helper.rb，确认已经包含加载support目录下所有文件的代码（如果没有就补上）：

# 加载spec/support目录下的所有配置文件
Dir[Rails.root.join('spec', 'support', '**', '*.rb')].sort.each { |f| require f }

3. 可选：自定义文件名规则
   如果你想保留部分测试描述的辨识度，又不想文件名太长，可以用哈希值缩短描述：

# 对测试完整描述取MD5哈希，截取前10位，兼顾唯一性和简洁性
description_hash = Digest::MD5.hexdigest(example.full_description)[0..10]
screenshot_name = "screenshot_#{description_hash}_#{Time.now.strftime('%Y%m%d_%H%M%S')}.png"

原理说明 #

这个方法通过RSpec的after(:example)钩子，在系统测试失败时触发自定义截图逻辑。page.save_screenshot是Capybara提供的方法，底层会调用selenium-webdriver生成截图，我们只需要指定自定义的文件路径，就能覆盖默认的长文件名规则。

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