Rails 7生产环境连接远程PostgreSQL时错误连接postgres库

核心问题分析 #

rails db:setup在生产环境下会先尝试连接PostgreSQL默认的postgres库，用于创建目标数据库。如果你的远程实例限制了该库的访问，或者配置的数据库用户无权限访问它，就会触发ActiveRecord::NoDatabaseError或PG::ConnectionBad错误——哪怕你已经正确配置了correct_db。

排查与解决步骤 #

1. 替换db:setup命令 #

如果已经手动确认能连接correct_db，直接跳过库创建步骤，改用：

RAILS_ENV=production rails db:migrate

db:migrate会直接连接配置的目标库，无需先访问postgres库。

2. 验证连接配置是否真的生效 #

执行以下命令输出当前生产环境的数据库配置，确认database字段是否为correct_db：

RAILS_ENV=production rails runner "puts ActiveRecord::Base.connection_config"

如果输出的database不是correct_db，再检查：

• config/database.yml中生产环境的database配置是否拼写正确
• 确认credentials中的值是否正确注入（比如ERB语法<%= Rails.application.credentials.prod_db[:password] %>是否解析正常）
• 再执行echo $DATABASE_URL确认是否有隐藏环境变量覆盖配置

3. 检查数据库用户权限 #

如果一定要用db:setup，需要确保配置的用户有两个权限：

• 能连接postgres库
• 有创建数据库的权限

远程登录PostgreSQL执行以下SQL检查：

SELECT rolcreatedb FROM pg_roles WHERE rolname = '你的数据库用户名';

如果rolcreatedb返回f，要么给用户添加创建库权限：

ALTER ROLE "你的数据库用户名" CREATEDB;

要么手动提前创建correct_db库：

CREATE DATABASE correct_db;

4. 排查Rails 7的默认配置干扰 #

检查config/application.rb中的config.load_defaults 7.0，部分默认配置可能影响连接逻辑：

• 确认config/initializers下没有自定义代码覆盖数据库连接配置
• 排查第三方gem是否修改了数据库连接参数（比如监控、缓存类gem）

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