本地Node.js应用通过pg模块无法连接容器化PostgreSQL

1. 确认容器端口映射配置 #

检查docker-compose.yml中PostgreSQL服务的ports字段，确保容器的5432端口正确映射到宿主机端口：

services:
  postgres:
    image: postgres:latest
    ports:
      - "5432:5432" # 宿主机端口:容器端口，必须配置这一行
    environment:
      POSTGRES_USER: your_user
      POSTGRES_PASSWORD: your_password
      POSTGRES_DB: your_db

如果映射的是其他宿主机端口（比如5433:5432），Node.js连接配置里的端口必须对应改成5433。

2. 核对Node.js数据库连接参数 #

确保pg模块的连接配置和容器环境变量完全匹配：

const { Pool } = require('pg');
const pool = new Pool({
  user: 'postgres', // 对应POSTGRES_USER
  host: 'localhost', // 宿主机地址，本地应用用localhost即可
  database: 'storefront', // 对应POSTGRES_DB
  password: 'your_password', // 对应POSTGRES_PASSWORD
  port: 5432, // 对应宿主机映射的端口
});

• 注意：不要用容器名称作为host，因为本地Node.js运行在宿主机，而非容器网络内，容器名称仅在容器间互通时有效。
• 若localhost无法连接，可尝试替换为宿主机的实际IP（比如192.168.1.100）。

3. 检查本地防火墙/安全组 #

确认本地防火墙没有拦截5432端口的入站/出站请求：

• Windows：打开「Windows Defender防火墙」，检查是否允许PostgreSQL相关的网络连接，或临时关闭防火墙测试。
• macOS/Linux：执行sudo ufw allow 5432（Ubuntu/Debian）或对应防火墙命令开放端口。

4. 验证容器内PostgreSQL的监听设置 #

进入容器检查postgresql.conf的监听配置：

docker exec -it <container-id> cat /var/lib/postgresql/data/postgresql.conf | grep listen_addresses

确保输出为listen_addresses = '*'，允许所有IP访问（官方PostgreSQL镜像默认已配置）。

5. 测试宿主机到容器的网络连通性 #

用telnet或nc命令测试端口是否可达：

telnet localhost 5432
# 或
nc -zv localhost 5432

如果连接失败，说明端口映射或容器网络存在问题，需重新检查docker-compose.yml的网络配置。

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