Docker部署PostgreSQL在IntelliJ中无法显示，求助排查

问题现象 #

• 通过Docker Compose部署PostgreSQL 14.11和Keycloak，PostgreSQL配置中指定POSTGRES_DB: telegram-clone
• 容器日志明确显示CREATE DATABASE执行成功，且数据库系统已就绪
• 终端执行psql -h localhost -p 5432 -U postgres连接后，用\l查看数据库列表为空
• IntelliJ测试数据源时提示目标数据库不存在

核心原因分析 #

1. 端口冲突：本地PostgreSQL占用5432端口 #

如果本地机器已运行PostgreSQL服务，会占用5432端口，此时Docker映射的5432:5432无法让外部连接到容器内的PostgreSQL，你执行psql连接的是本地的PostgreSQL实例，而非容器内的。

2. 数据卷映射错误 #

PostgreSQL配置中：

• PGDATA指定容器内数据目录为/var/lib/postgresql/data
• 但卷挂载配置是postgres:/data/postgres，两者路径不匹配

这会导致PostgreSQL的实际数据目录未被持久化到外部卷，容器重启或初始化后，数据库数据无法保留；甚至每次启动容器都会重新初始化一个空的数据库集群。

解决方案 #

步骤1：检查并解决端口冲突 #

执行命令查看本地5432端口的占用情况：

# Linux/macOS
lsof -i :5432
# 或
netstat -tulpn | grep 5432

# Windows（PowerShell）
Get-NetTCPConnection -LocalPort 5432

如果发现本地有PostgreSQL服务在运行：

• 停止本地PostgreSQL服务，再重启Docker容器
• 或者修改Docker Compose中PostgreSQL的端口映射，比如改成5433:5432，之后用psql -h localhost -p 5433 -U postgres连接

步骤2：修正数据卷映射配置 #

修改Docker Compose中PostgreSQL的volumes字段，让挂载路径与PGDATA一致：

services:
  postgres:
    container_name: postgres-sql-wac
    image: postgres:14.11
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: 1
      PGDATA: /var/lib/postgresql/data
      POSTGRES_DB: telegram-clone
    volumes:
      - postgres:/var/lib/postgresql/data  # 修正为PGDATA指定的路径
    ports:
      - 5432:5432
    networks:
      - telegram-clone
    restart: unless-stopped
# 其他配置保持不变

步骤3：清理旧卷并重新部署 #

旧的卷可能存储了错误的数据，需要彻底清理后重新启动：

# 停止容器并删除关联卷
docker-compose down -v
# 重新启动服务
docker-compose up -d

步骤4：验证连接 #

重新连接容器内的PostgreSQL，验证数据库是否存在：

# 直接连接到telegram-clone数据库
psql -h localhost -p 5432 -U postgres -d telegram-clone

# 或连接后查看数据库列表
psql -h localhost -p 5432 -U postgres
# 执行\l命令，此时应能看到telegram-clone数据库

日志佐证 #

从容器日志中可以看到CREATE DATABASE的输出，说明初始化阶段确实创建了目标数据库，但由于端口冲突或卷映射错误，外部连接无法访问到正确的数据库实例。

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