Docker中使用Rspec搭配database_cleaner触发RemoteDatabaseUrl错误

问题场景 #

在Docker环境执行测试命令：

bundle exec rspec ./spec/services/something/something_spec.rb

触发错误：

DatabaseCleaner::Safeguard::Error::RemoteDatabaseUrl:
ENV['DATABASE_URL'] is set to a remote URL

解决方案 #

• 配置测试专用本地数据库
  不要直接使用远程数据库跑测试，在Docker Compose中新增测试数据库服务（比如PostgreSQL），然后在测试环境配置中指向该容器内的数据库地址。例如DATABASE_URL=postgres://test_user:test_pass@db_test:5432/app_test，其中db_test是Compose中定义的测试数据库服务名。

• 临时禁用远程URL防护（仅限测试环境）
  在spec_helper.rb或rails_helper.rb中添加配置关闭防护：

  DatabaseCleaner.safeguard = false
  

  也可以仅针对测试环境生效：

  DatabaseCleaner.safeguard = false if Rails.env.test?
  

  注意：此操作仅适合本地测试，绝对不能在生产环境使用。

• 强制加载测试环境变量
  启动容器时明确指定测试环境及对应数据库URL，避免继承其他环境的配置：

  docker run -e RAILS_ENV=test -e DATABASE_URL=postgres://test_user:test_pass@db_test:5432/app_test your-app-image bundle exec rspec ./spec/services/something/something_spec.rb
  

• 调整DatabaseCleaner版本
  部分版本的防护逻辑可能过于严苛，尝试锁定或升级到稳定版本。在Gemfile中指定：

  gem 'database_cleaner-active_record', '~> 2.0.1'
  

  执行bundle install后重新运行测试。

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