本地Rails应用连接PostgreSQL失败：密码认证错误求助

1. 直接验证PostgreSQL用户密码有效性 #

跳过Rails，用psql命令直接测试数据库连接，排除Rails层面的问题：

psql -U postgres -h 127.0.0.1 -W

输入密码alex70gou，如果能成功进入psql交互界面，说明PostgreSQL端密码配置正常；如果仍失败，说明密码未真正生效，需检查认证规则。

2. 检查pg_hba.conf认证规则 #

PostgreSQL的pg_hba.conf文件控制客户端认证方式，不同系统路径不同：

• Linux：/var/lib/postgresql/<版本号>/main/pg_hba.conf
• macOS（Homebrew安装）：/usr/local/var/postgres/pg_hba.conf
• Windows：C:\Program Files\PostgreSQL\<版本号>\data\pg_hba.conf

找到对应本地连接的配置行，确保认证方式为md5（需要密码校验），而非peer（依赖系统用户匹配）或trust（无密码）：

# IPv4本地连接
host    all             all             127.0.0.1/32            md5
# IPv6本地连接
host    all             all             ::1/128                 md5

修改后必须重启PostgreSQL服务：

• Linux：sudo systemctl restart postgresql
• macOS：brew services restart postgresql
• Windows：在系统服务管理器中重启PostgreSQL服务

3. 排查环境变量覆盖问题 #

Rails会优先读取环境变量中的数据库配置，比如POSTGRES_PASSWORD或DATABASE_URL，这些变量会覆盖database.yml的设置。检查环境变量：

# Linux/macOS
echo $POSTGRES_PASSWORD
echo $DATABASE_URL

# Windows（PowerShell）
echo $env:POSTGRES_PASSWORD
echo $env:DATABASE_URL

如果输出了与database.yml不一致的密码或连接字符串，需清空对应环境变量，或调整为匹配的配置。

4. 优化database.yml配置细节 #

你的配置基本正常，可尝试调整以下点：

• 将host: localhost改为host: 127.0.0.1，避免localhost解析差异
• 确保配置使用空格缩进（禁止用制表符）
• 简化配置测试：

default: &default
  adapter: postgresql
  encoding: unicode
  username: postgres
  password: alex70gou
  host: 127.0.0.1
  pool: 5

development:
  <<: *default
  database: artur_development

5. 确认PostgreSQL监听端口 #

检查PostgreSQL是否在5432端口正常监听：

# Linux/macOS
lsof -i :5432

# Windows
netstat -ano | findstr :5432

如果无结果，说明服务未启动或端口被修改，需查看postgresql.conf中的port配置，确保值为5432。

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