Docker部署PostgreSQL后TablePlus连接提示root用户密码验证失败求助

1. 先验证容器内的用户与密码有效性 #

进入运行中的容器，直接用PostgreSQL自带的psql工具登录验证，确认用户和密码是否真的正确配置：

# 进入容器终端
docker exec -it postgres12 bash
# 使用指定用户名登录默认postgres数据库
psql -U root -d postgres

如果能成功进入数据库命令行，说明容器内的用户和密码没问题，问题出在客户端连接配置；如果这里也登录失败，说明容器初始化时用户创建异常，需要彻底清理容器后重新启动。

2. 排查TablePlus连接配置细节 #

• 确认数据库名：默认情况下，POSTGRES_USER对应的默认数据库是postgres，不是用户名root，别填错数据库名称。
• 检查SSL设置：PostgreSQL 12-alpine镜像默认禁用SSL，若TablePlus强制开启SSL选项会导致认证失败，尝试关闭SSL连接选项。
• 清除连接缓存：删除现有连接配置，重新创建新的连接，避免TablePlus缓存旧密码或错误配置。

3. 正确修改pg_hba.conf（避免容器重启后配置丢失） #

直接进入容器修改pg_hba.conf，重启后配置会被镜像重置，因为官方PostgreSQL镜像启动时会初始化默认配置。正确做法是挂载自定义配置文件：

1. 从容器内复制默认配置到本地：

docker cp postgres12:/var/lib/postgresql/data/pg_hba.conf ./pg_hba.conf

2. 修改本地的pg_hba.conf，将需要的认证方式改为trust（比如本地连接相关行）：

# "local" is for Unix domain socket connections only
local   all             all                                     trust
# IPv4 local connections:
host    all             all             127.0.0.1/32            trust
# IPv6 local connections:
host    all             all             ::1/128                 trust

3. 删除旧容器并重新启动，挂载自定义配置：

docker stop postgres12 && docker rm postgres12
docker run --name postgres12 -p 5432:5432 \
  -e POSTGRES_USER=root -e POSTGRES_PASSWORD=secret \
  -v $(pwd)/pg_hba.conf:/var/lib/postgresql/data/pg_hba.conf \
  -d postgres:12-alpine

注意：确保本地pg_hba.conf的权限正确，否则PostgreSQL进程无法读取会导致容器启动失败。

4. 检查端口占用情况 #

本地可能已有PostgreSQL服务占用5432端口，导致TablePlus连接的是本地服务而非Docker容器。可以用以下命令排查：

# Linux/macOS
lsof -i :5432
# Windows
netstat -ano | findstr :5432

若发现其他进程占用端口，要么停止本地PostgreSQL服务，要么修改Docker端口映射为其他端口（比如5433:5432），然后TablePlus连接时使用新端口。

内容的提问来源于stack exchange，提问作者Khánh Duyền