Linux下Rails执行db:setup时PostgreSQL 5432端口拒绝TCP/IP连接求助

看起来你碰到的是典型的本地Unix套接字连接正常，但TCP连接被拒绝的问题——psql默认可能用Unix套接字连接（不需要走5432端口），而Rails默认会尝试TCP连接，所以才会出现这种“服务正常但命令失败”的矛盾情况。下面一步步排查解决：

• 第一步：确认PostgreSQL是否真的在监听TCP端口
  先别急着改配置，先确认服务实际的监听状态：

  ss -tulpn | grep postgres
  

  如果输出里没有0.0.0.0:5432或者:::5432的行，说明PostgreSQL根本没在监听TCP端口——哪怕你改了listen_addresses = '*'，也可能是配置文件不对或者没重启服务。

• 第二步：找到正确的postgresql.conf文件
  有时候Yaourt安装的PostgreSQL配置路径和默认不同，先查当前生效的配置文件：

  psql -c 'SHOW config_file;'
  

  打开这个文件，确认：

  • listen_addresses = '*'（取消注释，值为*或者包含127.0.0.1）
  • port = 5432（取消注释，确保端口正确）
    改完后必须重启服务：

  systemctl restart postgresql.service
  

  再用第一步的命令确认监听状态。

• 第三步：检查pg_hba.conf的TCP连接规则
  即使监听了端口，pg_hba.conf也可能拒绝TCP连接。找到和postgresql.conf同目录的pg_hba.conf，添加/修改以下规则（放在文件靠前位置，因为规则匹配是从上到下）：

  host    all             all             127.0.0.1/32            scram-sha-256
  host    all             all             ::1/128                 scram-sha-256
  

  这里scram-sha-256是PostgreSQL 10+的默认认证方式，如果你的版本较低，换成md5就行。改完后再次重启服务。

• 第四步：测试TCP连接是否正常
  用强制TCP连接的方式测试psql：

  psql -h 127.0.0.1 -p 5432 -U <你的PostgreSQL用户名> <你的数据库名>
  

  如果这个命令能成功，说明TCP连接没问题，问题出在Rails的database.yml配置上：

  • 检查host是否设为127.0.0.1（而不是localhost，有些系统下localhost会优先走Unix套接字）
  • 确认port是5432，用户名、密码和PostgreSQL的配置一致

• 第五步：排查防火墙/SELinux干扰
  如果你开了防火墙（比如ufw），确保5432端口被允许：

  ufw allow 5432/tcp
  

  若是SELinux处于enforcing模式，可能会阻止PostgreSQL监听端口，临时关闭测试：

  setenforce 0
  

  如果关闭后问题解决，再配置SELinux允许PostgreSQL的端口访问（避免永久关闭SELinux）。

• 第六步：查看PostgreSQL日志找线索
  如果以上都没解决，去日志文件里找具体错误：

  # 日志路径可能是以下其中一个
  tail -f /var/log/postgresql/postgresql-<版本号>-main.log
  # 或者
  tail -f /var/lib/postgres/data/log/postgresql.log
  

  日志里会明确告诉你连接失败的原因——是认证错误、端口没监听，还是其他权限问题。

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