Docker部署PostgreSQL后pgcli本地连接失败问题求助

排查与修复步骤 #

1. 检查端口映射配置 #

你启动容器时的端口映射为 -p 5432:5431，这将主机5432端口转发到容器内的5431端口，但PostgreSQL默认监听5432端口：

• 进入容器执行 psql -U root -d ny_taxi -c "SHOW port;"，确认容器内PostgreSQL的监听端口。
• 如果端口是默认5432，说明端口映射写反了，重新启动容器时改为 -p 5432:5432。
• 若容器内确实配置为5431端口，请确保pgcli连接时使用主机端口5432（即当前命令的 -p 5432 参数是正确的）。

2. 验证主机端口是否被占用 #

主机5432端口可能被本地PostgreSQL或其他程序占用：

• Windows下执行命令：netstat -ano | findstr :5432，查看占用端口的进程ID。
• 若有占用，可停止对应进程，或修改容器映射端口（例如 -p 5433:5432），并在pgcli连接时使用 -p 5433。

3. 调整PostgreSQL外部连接配置 #

容器内部能连接但外部失败，可能是PostgreSQL限制了外部访问：

• 进入容器，编辑 /var/lib/postgresql/data/postgresql.conf，设置 listen_addresses = '*'。
• 编辑 /var/lib/postgresql/data/pg_hba.conf，添加一行：host all all 0.0.0.0/0 md5。
• 重启容器内的PostgreSQL服务：pg_ctl restart -D /var/lib/postgresql/data，或直接重启容器。

4. 检查容器运行状态 #

• 查看容器日志排查异常：docker logs <容器ID>，搜索连接相关的错误信息。
• 尝试重启容器：docker restart <容器ID>，重启后再次用pgcli连接测试。

5. 确认pgcli连接参数 #

确保命令参数与容器配置匹配：

• 用户名、数据库名需与启动容器时的 POSTGRES_USER、POSTGRES_DB 一致（当前为 root 和 ny_taxi）。
• 主机地址使用 localhost 是正确的，若Docker使用WSL2后端，也可尝试使用WSL的IP地址。

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