Docker部署PostgreSQL出现postgres用户认证失败问题求助

核心原因 #

当通过POSTGRES_USER环境变量指定自定义用户（如my_db_user）时，PostgreSQL 16.1镜像不会创建默认的postgres系统用户。此时任何针对postgres用户的连接请求都会触发FATAL: password authentication failed for user "postgres"（角色不存在）的错误。

排查与解决步骤 #

1. 定位连接请求来源 #

先查看容器日志的详细输出，确认请求的来源IP和端口：

docker-compose logs -f postgres

• 如果来源是容器内部：检查是否有自定义初始化脚本、定时任务或附加进程在尝试使用postgres用户连接。进入容器排查进程：

  docker-compose exec postgres bash
  ps aux | grep postgres
  

  若发现异常进程，修改对应脚本的数据库用户为my_db_user。

• 如果来源是外部：检查宿主机或其他客户端（如pgAdmin）是否有旧的连接配置误用了postgres用户，删除或修正这些配置即可。

2. 检查Docker Compose配置 #

确保环境变量配置完全覆盖默认用户，示例正确配置：

services:
  postgres:
    image: postgres:16.1
    environment:
      POSTGRES_USER: my_db_user       # 自定义用户名
      POSTGRES_PASSWORD: your_secure_password  # 对应密码
      POSTGRES_DB: my_default_db      # 可选：指定默认数据库
    ports:
      - "5433:5432"
    volumes:
      - ./postgres-data:/var/lib/postgresql/data

注意：不要混合使用默认用户和自定义用户的配置，避免初始化逻辑冲突。

3. 重置数据库数据卷（若存在旧数据残留） #

如果之前用过默认postgres用户启动容器，数据卷可能残留旧的用户配置，导致初始化异常：

# 停止并删除容器及关联数据卷
docker-compose down -v
# 备份现有数据（若需要）
cp -r ./postgres-data ./postgres-data-backup
# 重新启动容器，初始化新的自定义用户环境
docker-compose up -d

4. 确认宿主机端口状态 #

虽然lsof -i :5432无结果，可通过ss命令再次验证端口占用：

ss -tulpn | grep 5432

若仍无结果，说明5432端口确实未被占用，之前的端口冲突可能是临时残留的连接会话导致。

内容的提问来源于stack exchange，提问作者Yaroslav-BV