Ruby-Rspec非Rails项目测试失败时无法自动生成截图求助

我明白你现在的困境——在非Rails的Ruby项目里用RSpec和Capybara，手动能截图但测试失败时没法自动触发。别担心，咱们一步步来解决这个问题：

问题根源 #

虽然你已经引入了capybara-screenshot/rspec，但在非Rails环境下，这个库的自动集成可能没有完全生效，需要我们手动添加RSpec的失败钩子来触发截图逻辑。

解决方案 #

1. 在spec_helper.rb中添加RSpec失败钩子 #

打开你的spec_helper.rb，在现有配置基础上添加RSpec配置块，用来在测试失败时自动触发截图：

# frozen-string-literal: true
require 'rspec'
require 'capybara/rspec'
require 'capybara-screenshot/rspec'
require 'capybara/dsl'
require 'selenium-webdriver'
require 'site_prism'
Dir[File.dirname(__FILE__) + '/page_objects/*/*.rb'].each do |page_object|
  require page_object
end

# 确保截图目录存在，避免因目录缺失导致保存失败
FileUtils.mkdir_p(Capybara.save_path) unless Dir.exist?(Capybara.save_path)

Capybara.register_driver :selenium do |app|
  Capybara::Selenium::Driver.new(app, browser: :chrome)
end
Capybara.save_path = "#{Dir.pwd}/screenshots"
Capybara.default_driver = :selenium
Capybara.app_host = "REDACTED"
Capybara.default_max_wait_time = 20

# 添加RSpec失败钩子，自动触发截图
RSpec.configure do |config|
  config.after(:example) do |example|
    # 检测测试用例是否失败（有异常抛出）
    if example.exception
      # 执行截图并保存页面
      Capybara::Screenshot.screenshot_and_save_page
    end
  end
end

2. 确认capybara-screenshot自动保存配置（可选） #

如果上面的钩子还没生效，可以尝试手动开启自动保存开关，在spec_helper.rb里添加：

Capybara::Screenshot.autosave_on_failure = true

这个选项默认是true，但在非Rails环境下有时候需要显式声明来确保生效。

3. 测试验证 #

现在运行你的测试文件：

rspec my_spec.rb

当测试失败时，你应该能在screenshots目录下看到生成的截图和对应的HTML页面文件了。

额外排查点 #

• 确保capybara-screenshot和capybara版本兼容，可以运行bundle update capybara capybara-screenshot更新到最新兼容版本。
• 检查screenshots目录的权限，确保当前用户有读写权限。

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