如何在Ruby on Rails的Minitest单元测试中正确模拟环境变量？

1. 基础方案：手动修改ENV并恢复 #

直接操作全局的ENV哈希，在测试前后保存和恢复原始值，不需要额外依赖：

class MyServiceTest < Minitest::Test
  def setup
    # 先存好原始值，避免测试污染全局环境
    @original_api_key = ENV['API_KEY']
    # 设置模拟的环境变量值
    ENV['API_KEY'] = 'test_api_123'
  end

  def teardown
    # 测试结束后恢复：如果原来没这个变量就删掉，否则还原值
    if @original_api_key.nil?
      ENV.delete('API_KEY')
    else
      ENV['API_KEY'] = @original_api_key
    end
  end

  def test_api_request_uses_mocked_key
    response = MyService.make_request
    assert_equal 'test_api_123', response.request.headers['X-API-Key']
  end
end

2. 局部模拟：用around钩子 #

如果只需要给单个测试用例模拟环境变量，用around钩子更灵活，不用全局的setup/teardown：

class MyControllerTest < Minitest::Test
  def test_feature_toggle_enabled
    around do |test|
      original_toggle = ENV['FEATURE_X_ENABLED']
      ENV['FEATURE_X_ENABLED'] = 'true'
      
      test.run # 执行当前测试逻辑
      
      # 恢复环境变量
      original_toggle ? ENV['FEATURE_X_ENABLED'] = original_toggle : ENV.delete('FEATURE_X_ENABLED')
    end

    get '/feature-x'
    assert_response :success
  end
end

3. 复用方案：封装自定义辅助方法 #

把环境变量模拟逻辑封装成辅助方法，在多个测试类里复用：
先在test/test_helper.rb里添加：

module EnvMockHelper
  def with_env(key, value)
    original_value = ENV[key]
    ENV[key] = value
    yield # 执行传入的测试代码块
  ensure
    # 无论代码块是否报错，都恢复环境变量
    original_value ? ENV[key] = original_value : ENV.delete(key)
  end
end

# 让所有测试类都能使用这个方法
class Minitest::Test
  include EnvMockHelper
end

然后在测试里直接调用：

def test_payment_process_with_test_mode
  with_env('PAYMENT_MODE', 'test') do
    result = PaymentProcessor.process(amount: 100)
    assert result.test_mode?
  end
  # 代码块结束后自动恢复原始环境变量
end

4. 优雅方案：使用climate_control gem #

如果不想自己写恢复逻辑，可以用专门的climate_control gem，它封装了环境变量的临时修改和自动恢复：

1. 先在Gemfile的test组添加：gem 'climate_control'，然后执行bundle install
2. 测试中使用：

def test_email_service_uses_mocked_sender
  ClimateControl.modify EMAIL_SENDER: 'test@example.com' do
    email = EmailService.send_welcome('user@test.com')
    assert_equal 'test@example.com', email.from
  end
end

方案选择建议 #

• 简单场景（单个测试/少量测试）：用手动修改或around钩子，无额外依赖
• 多个测试需要复用：封装自定义辅助方法
• 追求代码简洁：使用climate_control gem

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