通过Render.com部署后本地无法连接PostgreSQL的问题求助

在Render.com成功部署应用后，本地开发时无法连接数据库，执行rails db:reset报错：

rails aborted!
ActiveRecord::ConnectionNotEstablished: could not translate host name "xxxxxxxxxxxx" to address: Name or service not known

希望解决该错误以正常本地开发，同时担心操作会影响已部署的线上应用。

环境信息：Ruby 3.1.2，Rails 7.0.4

1. 排查环境变量冲突 #

Rails会优先读取DATABASE_URL环境变量，覆盖database.yml的配置。你本地大概率不小心设置了生产环境的DATABASE_URL（指向Render的数据库），导致本地尝试连接线上数据库但解析失败：

• 终端执行echo $DATABASE_URL，如果输出包含报错里的主机名，说明就是这个问题。
• 临时修复：终端执行unset DATABASE_URL，再重新运行rails db:reset。
• 永久修复：检查你的shell配置文件（比如.bashrc、.zshrc、.profile），找到设置DATABASE_URL的行，删除或注释掉，重启终端生效。

2. 确认本地PostgreSQL状态 #

确保本地PostgreSQL服务正在运行：

• macOS（Homebrew）：brew services start postgresql
• Ubuntu/Debian：sudo systemctl start postgresql
• Windows：在系统服务列表中启动PostgreSQL服务

3. 验证本地数据库配置 #

检查database.yml的development和test段：

• 确保没有强制设置错误的host（默认注释host会用Unix socket连接，Windows需取消注释设为localhost）
• 确认数据库名（k_development、k_test）正确，若本地未创建对应数据库，执行createdb k_development和createdb k_test手动创建

完全不用担心！本地的环境变量和数据库配置修改，不会影响Render上的生产应用。生产环境的配置是存储在Render平台的环境变量里的，和本地环境完全隔离。只要你不把错误的配置代码推送到Git仓库，就不会对线上应用造成任何影响。

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