Rails系统测试中使用VCR.use_cassette仍提示未找到cassette如何解决

核心原因汇总 #

• 系统测试异步请求未被VCR块覆盖：click_on触发的请求是异步执行的，代码未等待请求完成就退出了VCR.use_cassette的作用域，导致请求发出时没有加载对应的cassette
• 浏览器侧请求无法被VCR捕获：如果OAuth请求是前端浏览器直接发起的，VCR仅能拦截Ruby层发出的HTTP请求，无法捕获浏览器直接发送的外部请求
• 请求匹配规则不匹配：默认的[:method, :uri]匹配规则未覆盖POST请求的请求体，当同URL的POST请求携带不同参数时会被判定为未匹配请求
• VCR配置遗漏：全局配置中忽略了对应OAuth域名，或者未对使用的HTTP库开启钩子

排查解决步骤 #

1. 确认请求发起来源
   检查OAuth接口的请求是后端Ruby代码发起还是前端直接发起：如果是前端发起的请求，VCR无法拦截，可选择以下方案：

• 测试环境跳过第三方OAuth验证，直接使用mock登录态
• 更换支持浏览器请求拦截的测试驱动（如Cuprite），用驱动自带的API mock第三方接口返回

2. 补全异步等待逻辑
   在click_on之后加页面断言，确保请求完成后再退出VCR块，修改测试代码如下：

require "application_system_test_case"

class ImportTest < ApplicationSystemTestCase
  test "importing vacancy succeeds" do
    VCR.use_cassette("import_success", record: :all, match_requests_on: [:method, :uri, :body, :headers]) do
      user = users(:role)
      sign_in(user)

      visit new_externals_path

      within "form.form" do
        fill_in "External ID", with: "57524"
        click_on "Import Vacancy"
      end

      # 加等待断言，确保异步请求完成再退出VCR块，提示文案可替换为实际业务中的成功提示
      assert_text "Vacancy imported successfully"
      # 补充你原本的TODO校验逻辑
    end
  end
end

3. 调整VCR匹配规则
   在use_cassette参数中添加请求体、头的匹配规则，确保POST请求参数能被正确匹配，参考上面代码中的match_requests_on配置。

4. 校验VCR全局配置
   检查config/initializers/vcr.rb中的配置：

• 确认没有把url.com加到ignore_hosts列表中
• 如果你使用的HTTP库不是默认的Net::HTTP（如Faraday、HTTPClient），需要添加对应的hook配置，例如：

VCR.configure do |config|
  config.cassette_library_dir = "test/vcr_cassettes"
  config.hook_into :webmock, :faraday # 补全你用到的HTTP库
  config.allow_http_connections_when_no_cassette = false
end

5. 清理旧cassette
   删除test/vcr_cassettes/import_success.yml文件后重新运行测试，避免旧的不完整录制文件影响。

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