Docker部署PostgreSQL后无法通过SQL查询工具连接的问题排查

针对你遇到的容器内可正常访问数据库，但外部SQL工具连接时报“数据库未找到/Postgres角色未找到”的问题，结合你的配置文件，排查以下关键问题并给出修复方案：

1. 环境变量冲突 #

你同时配置了env_file: .env和environment块，若.env文件中存在POSTGRES_DB、POSTGRES_USER或POSTGRES_PASSWORD变量，会直接覆盖environment里的设置，导致实际生效的数据库/角色与预期不符。

解决步骤：

• 打开.env文件，检查是否有重复的PostgreSQL环境变量，如有则删除或修改为匹配的值；
• 暂时注释掉env_file: .env行，重启容器后测试连接，验证是否为变量冲突导致的问题。

2. 数据卷遗留旧数据 #

PostgreSQL镜像仅在首次启动且数据卷为空时，才会通过POSTGRES_*环境变量初始化数据库和角色。如果./postgres目录之前已有旧的数据库数据，容器启动时会直接复用旧数据，完全忽略当前的环境变量配置。

解决步骤：

• 停止并删除容器：

  docker-compose down
  

• 删除本地数据卷目录：

  rm -rf ./postgres
  

• 重新构建并启动容器：

  docker-compose up -d --build
  

3. Dockerfile自定义配置干扰 #

你的Dockerfile执行了COPY runtime/ /，若runtime目录下包含PostgreSQL核心配置文件（如pg_hba.conf、postgresql.conf），可能覆盖官方镜像的默认配置，引发以下问题：

• postgresql.conf中listen_addresses未设置为*，容器仅监听内部localhost，外部无法建立连接；
• pg_hba.conf未添加允许外部主机连接的规则，导致连接被拒绝（表现为角色/数据库找不到）。

解决步骤：

• 若不需要自定义PostgreSQL配置，直接删除Dockerfile中的COPY runtime/ /行；
• 若需保留自定义配置，确保：
  • postgresql.conf中设置listen_addresses = '*'；
  • pg_hba.conf中添加规则：host all all 0.0.0.0/0 md5（允许所有IP通过密码认证连接）。

4. 验证容器内实际配置 #

进入容器终端，确认数据库和角色是否存在：

docker exec -it pg_superset_dev bash
psql -U postgres

执行SQL查询：

-- 查看所有数据库
SELECT datname FROM pg_database;
-- 查看所有角色
SELECT usename FROM pg_user;

确认输出中存在postgres数据库和postgres角色。

5. DBeaver连接参数检查 #

确保DBeaver的连接配置完全匹配：

• 主机：localhost（或容器所在机器的IP）
• 端口：5432
• 数据库：postgres
• 用户名：postgres
• 密码：P@ssw0rd
• 认证方式选择MD5

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