Docker配置Nest+Postgres时报ECONNREFUSED 127.0.0.1:5432如何解决

核心问题原因 #

• 你的 Node 应用代码未读取 DATABASE_URL 环境变量，仍然硬编码了数据库连接地址为 127.0.0.1:5432。Docker Compose 内部网络中 Postgres 服务的访问域名就是服务名 postgres，你配置的 DATABASE_URL: postgres://user:password@postgres:5432/db 是完全正确的，只需修改代码中的数据库连接逻辑，读取环境变量中的连接配置即可。
• depends_on 仅控制容器启动顺序，不等待 Postgres 完成初始化逻辑。Postgres 首次启动需要创建用户、初始化数据库，耗时通常在 3-10 秒，此时 API 提前启动就会触发连接拒绝报错。
• 配置中 NODE_ENV 拼写错误，正确拼写为 development，该错误可能导致开发环境配置加载异常，建议同步修正。

验证&排查步骤 #

• 先验证 Postgres 容器本身运行正常：使用本地数据库客户端连接 localhost:35000，用户名填 user，密码填 password，数据库名填 db，能正常连接说明 Postgres 服务无问题。
• 进入运行中的 API 容器执行 echo $DATABASE_URL，确认环境变量已被正确注入。
• 检查代码中数据库连接的 host、端口、用户名、密码等参数，确认全部从环境变量读取，没有硬编码的固定值。

启动等待优化方案 #

如果修改连接配置后仍然偶尔出现连接报错，可以给 API 加启动等待逻辑：

• 方案1：在代码中加数据库连接重试机制，最多重试 5-10 次，每次间隔 2 秒，适配 Postgres 启动耗时。
• 方案2：在 Dockerfile 的启动命令前加 wait-for-it 逻辑，等待 Postgres 端口通了之后再启动 Node 服务。

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