Rails生产环境dotenv配置异常：secret_key_base缺失如何解决？

核心原因 #

dotenv-rails默认仅在development和test环境自动加载.env文件，production环境需手动配置加载逻辑；另外Rails生产环境默认优先读取内置credentials中的secret_key_base，会覆盖环境变量值。

分步解决 #

1. 调整Gemfile的dotenv配置 #

如果你的Gemfile中dotenv是如下写法：

gem 'dotenv-rails', groups: [:development, :test]

删除groups限制，改为：

gem 'dotenv-rails'

执行bundle install更新依赖。

2. 配置Rails在生产环境加载.env.production #

打开config/application.rb，在Bundler.require(*Rails.groups)之后、Rails.application.initialize!之前，添加代码：

# 按当前环境加载对应.env文件
Dotenv::Railtie.load(".env.#{Rails.env}")

这样所有环境都会自动加载对应名称的.env文件，包括production。

3. 生成并配置SECRET_KEY_BASE到.env.production #

在终端执行命令生成密钥：

rails secret

将输出的长字符串复制到.env.production文件中：

SECRET_KEY_BASE=你刚才生成的密钥字符串

4. 让Rails优先读取环境变量的secret_key_base #

打开config/environments/production.rb，添加或修改配置：

Rails.application.configure do
  # 优先使用环境变量的secret_key_base，无值时再用credentials
  config.secret_key_base = ENV["SECRET_KEY_BASE"] || Rails.application.credentials.secret_key_base
end

5. 验证配置是否生效 #

在终端运行生产环境控制台：

RAILS_ENV=production rails console

输入ENV["SECRET_KEY_BASE"]，若输出你配置的密钥，说明dotenv加载成功。

6. 确保bin/setup执行时加载.env.production #

打开bin/setup，在文件最顶部添加：

require 'dotenv'
# 根据当前RAILS_ENV加载对应.env文件
Dotenv.load(".env.#{ENV['RAILS_ENV'] || 'development'}")

这样执行bin/setup时，生产环境的配置会被正确加载。

重新运行bin/setup即可正常执行production环境的db:reset操作。

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