Docker Compose部署PostgreSQL后无法进入psql终端问题排查

1. 先确认PostgreSQL服务是否真的在运行 #

进入容器后，先检查服务状态：

pg_isready -U postgres
# 或者直接查看进程
ps aux | grep postgres

如果服务没启动，去宿主机查看容器日志找原因：

docker-compose logs postgres-master

常见原因包括数据目录权限错误、POSTGRES_PASSWORD等关键环境变量未配置导致启动失败。

2. 核对PostgreSQL的socket路径 #

默认socket路径是/var/run/postgresql/，但如果docker-compose中修改了PGDATA环境变量或挂载了自定义数据目录，socket路径可能会变化。查看配置确认：

cat /var/lib/postgresql/data/postgresql.conf | grep unix_socket_directories

如果输出是/tmp这类其他路径，需要指定路径连接psql：

psql -d postgres -U postgres -h /tmp

3. 检查docker-compose.yaml的配置差异 #

对比之前成功的docker run命令，重点核对以下配置：

• 环境变量：POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_DB是否和之前一致
• 数据卷挂载：如果挂载了宿主机目录，需确保目录权限允许容器内postgres用户（UID为999）读写，宿主机上执行：

  chown -R 999:999 /path/to/your/postgres/data-folder
  

• 避免错误覆盖启动命令：如果docker-compose.yaml中指定了command字段，可能会覆盖默认的PostgreSQL启动命令，导致服务未正常启动（比如错误设置command: psql会直接进入psql而非启动数据库服务）。

4. 绕开socket，用localhost连接测试 #

直接指定localhost连接，排除socket配置问题：

psql -d postgres -U postgres -h localhost

如果能成功连接，说明是socket路径配置问题；如果仍失败，说明PostgreSQL服务未正常监听端口。

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