Rspec测试中ActiveStorage::Current.host的正确设置位置

核心原因 #

直接在rails_helper.rb里全局赋值ActiveStorage::Current.host无效，是因为它是请求级别的线程局部变量，RSpec的测试隔离机制（每个测试实例会重置上下文）会覆盖这个全局设置，导致测试运行时host回到nil。而Rails.application.routes.default_url_options不生效，是因为ActiveStorage生成URL时优先读取ActiveStorage::Current.host，不会 fallback 到路由的默认配置。

正确的设置位置 #

1. 全局生效：在RSpec配置的before钩子中设置

在spec/rails_helper.rb的RSpec.configure块中添加全局前置钩子，确保每个测试运行前都设置好host：

RSpec.configure do |config|
  config.before(:each) do
    ActiveStorage::Current.host = "https://example.com"
  end
end

2. 仅针对特定测试组设置

如果只需要在ActiveStorage相关的测试中生效，可以在对应的describe块内添加局部钩子：

describe "附件上传与URL生成测试" do
  before(:each) do
    ActiveStorage::Current.host = "https://example.com"
  end

  it "能正确生成附件的可访问URL" do
    # 你的测试逻辑
  end
end

3. 可选：用around钩子避免测试污染

为了防止线程局部变量在测试间泄漏，可使用around钩子在测试后重置host：

RSpec.configure do |config|
  config.around(:each) do |example|
    original_host = ActiveStorage::Current.host
    ActiveStorage::Current.host = "https://example.com"
    example.run
    ActiveStorage::Current.host = original_host
  end
end

补充说明 #

如果是编写request或system测试，除了设置ActiveStorage::Current.host，还可以用host!方法设置请求的host，但两者不冲突——ActiveStorage的URL生成依然依赖前者的线程局部变量配置。

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