官方PostgreSQL Docker镜像密码故障排查及重置方法

问题背景 #

使用官方PostgreSQL Docker镜像启动容器，启动命令如下：

docker run --rm -d \
        --name my-postgres \
        --network my-network \
        -e POSTGRES_USER=postgres \
        -e POSTGRES_PASSWORD=mysuperduperlongpwstring \
        -e POSTGRES_DB=postgres \
        -v /path/to/postgres/data/:/var/lib/postgresql/data
        postgres

通过Go语言创建PostgreSQL连接时，代码如下：

psqlInfo := fmt.Sprintf(
        "host=%s port=%s user=%s password=%s dbname=%s sslmode=%s",
        os.Getenv("DB_HOST"),
        os.Getenv("DB_PORT"),
        os.Getenv("DB_USER"),
        os.Getenv("DB_PASSWORD"),
        os.Getenv("DB_NAME"),
        os.Getenv("DB_SSL_MODE"),
)
db, err := sql.Open("postgres", psqlInfo)
if err != nil {
        panic(err)
}

始终抛出认证失败错误：

panic: pq: password authentication failed for user "postgres"

尝试验证密码有效性时遇到异常：

• 在容器内执行psql -U postgres -d postgres --password，输入任意密码均可成功登录；
• 在容器内修改密码时，报错：

ERROR:  must be superuser to alter replication roles or change replication attribute

多次修改启动密码并同步更新Go代码中的密码，问题仍未解决。

排查步骤 #

1. 检查挂载的数据卷是否存在旧数据 #

PostgreSQL官方镜像仅在首次启动且数据目录为空时，才会通过POSTGRES_PASSWORD等环境变量初始化数据库。如果/path/to/postgres/data/目录已存在旧的数据库文件，后续启动容器时环境变量的密码配置不会生效，仍使用旧密码。

2. 验证pg_hba.conf认证规则 #

进入容器查看/var/lib/postgresql/data/pg_hba.conf文件：

docker exec -it my-postgres cat /var/lib/postgresql/data/pg_hba.conf

如果本地连接（local或127.0.0.1）的认证方式为trust，则容器内使用psql登录时无需验证密码（任意输入都能通过）；而跨网络的连接（如Go程序通过my-network访问）可能使用md5认证，此时需匹配旧数据中的密码，导致认证失败。

3. 确认Go程序的环境变量配置 #

在Go代码中添加日志打印psqlInfo，验证DB_PASSWORD等环境变量是否正确加载为设置的mysuperduperlongpwstring，避免环境变量未正确注入或拼写错误。

4. 检查网络连通性 #

确认Go程序所在服务已加入my-network网络，且DB_HOST设置为容器名my-postgres，DB_PORT为默认的5432，确保网络层面能正常访问PostgreSQL服务。

重置密码的方法 #

方法1：清理旧数据重新初始化（最简单） #

1. 停止并删除容器：

docker stop my-postgres && docker rm my-postgres

2. 备份数据后删除本地挂载目录的内容（注意：此操作会清空所有数据库数据）：

rm -rf /path/to/postgres/data/*

3. 重新执行启动容器的命令，此时POSTGRES_PASSWORD会生效，初始化新的超级用户密码。

方法2：保留数据修改密码（适合需保留现有数据的场景） #

1. 进入容器：

docker exec -it my-postgres bash

2. 临时修改pg_hba.conf，将本地连接的认证方式改为trust（如果当前不是）：

vi /var/lib/postgresql/data/pg_hba.conf

找到类似local all postgres md5的行，改为trust。

3. 重启PostgreSQL服务：

pg_ctl restart -D /var/lib/postgresql/data

4. 无需密码登录psql：

psql -U postgres -d postgres

5. 修改postgres用户密码：

ALTER USER postgres PASSWORD 'your-new-password';

6. 将pg_hba.conf改回原认证方式（如md5），再次重启PostgreSQL服务，确保密码验证生效。

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