Rails 5仍需database.yml及生产环境凭证读取异常求助

我之前也踩过Rails 5这个坑！确实，Rails 5的credentials系统和后续的Rails 6+机制不同，哪怕你用credentials存敏感凭证，还是必须存在config/database.yml文件——这就是第一个报错的根源，而第二个undefined method []' for nil:NilClass则是因为credentials引用路径不匹配或者加载异常，下面一步步解决：

1. 明确Rails 5的核心限制 #

Rails 5的credentials主要用来存储敏感信息，但数据库配置的基础结构框架必须写在config/database.yml里，不能像Rails 6+那样直接在credentials里定义完整的数据库配置。开发环境能正常运行，是因为项目初始化时就自动生成了config/database.yml，而生产环境你没创建这个文件，所以才会提示找不到它。

2. 创建正确的config/database.yml并引用credentials #

先创建config/database.yml文件，生产环境部分通过Rails.application.credentials注入敏感信息，注意要和你credentials里的结构严格对应。

举个典型的PostgreSQL配置例子（如果是MySQL就把adapter改成mysql2）：

default: &default
  adapter: postgresql
  pool: 5
  timeout: 5000

development:
  <<: *default
  database: your_dev_db_name

test:
  <<: *default
  database: your_test_db_name

production:
  <<: *default
  database: your_production_db_name
  username: <%= Rails.application.credentials.production[:db_user] %>
  password: <%= Rails.application.credentials.production[:db_pass] %>
  host: your_db_host # 比如localhost或者云数据库地址

3. 检查credentials的结构是否匹配 #

打开生产环境的credentials确认内容：

RAILS_ENV=production EDITOR=vim rails credentials:edit

确保里面的结构和你database.yml里的引用路径一致，比如：

production:
  db_user: your_production_db_user
  db_pass: your_secure_production_password

如果你不想嵌套production:层级，直接写顶级键值对：

db_user: your_production_db_user
db_pass: your_secure_production_password

那database.yml里就要改成<%= Rails.application.credentials[:db_user] %>，否则就会因为找不到对应键而返回nil，进而触发undefined method []' for nil:NilClass错误。

4. 验证credentials是否正常加载 #

在生产环境控制台先单独测试credentials读取：

RAILS_ENV=production rails c

然后在控制台输入：

# 如果你用了production嵌套
Rails.application.credentials.production
# 或者直接读取键
Rails.application.credentials[:db_user]

如果返回nil，说明credentials没正确加载，要检查：

• 是否通过RAILS_ENV=production rails credentials:edit生成了生产环境专属的credentials文件（Rails 5.2+支持多环境credentials，会生成config/credentials/production.yml.enc和对应的config/credentials/production.key）
• 生产环境服务器上是否存在对应的key文件，或者是否设置了RAILS_MASTER_KEY环境变量来解密credentials（如果用环境变量，值要和production.key里的内容一致）

5. 最后验证 #

配置完成后，重新启动生产环境控制台：

RAILS_ENV=production rails c

如果能正常进入，说明配置没问题了。

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