Kubernetes中PostgreSQL用户postgres密码认证失败求助

1. 核对数据库用户的密码哈希类型 #

进入PostgreSQL Pod，本地登录数据库：

psql -U postgres

执行SQL查询用户密码的哈希格式：

SELECT rolname, rolpassword FROM pg_authid WHERE rolname = 'postgres';

如果返回的哈希以md5开头，说明密码是MD5格式，但pg_hba.conf要求使用scram-sha-256认证，这会直接导致认证失败。

解决办法：更新用户密码为SCRAM格式：

ALTER USER postgres WITH PASSWORD '111111';

执行完成后重启PostgreSQL Pod。

2. 检查pg_hba.conf的配置规则 #

如果是通过ConfigMap挂载的pg_hba.conf，打开postgres-config.yml确认：

• 远程连接的规则是否匹配你的客户端来源，比如集群内连接可配置为host all all 0.0.0.0/0 scram-sha-256，或者限制为具体网段。
• 注意：如果数据库初始化时用的是MD5认证，后续仅修改pg_hba.conf为SCRAM但未更新用户密码哈希，依然会报错。

3. 验证Secret的密码正确性 #

虽然环境变量显示正确，但需确认Secret存储的密码是否为原始明文：
执行命令解码Secret内容：

kubectl get secret postgres-secret -o jsonpath='{.data.POSTGRES_PASSWORD}' | base64 --decode

确保输出为111111，如果不符，重新创建Secret：

kubectl create secret generic postgres-secret --from-literal=POSTGRES_PASSWORD=111111 --from-literal=POSTGRES_USER=postgres --from-literal=POSTGRES_DB=你的数据库名

4. 确认客户端连接的认证兼容性 #

使用psql远程连接时，确保客户端版本支持SCRAM认证（PostgreSQL 10及以上版本默认支持），可显式指定连接参数：

psql "host=postgres-service port=5432 dbname=你的数据库名 user=postgres password=111111 sslmode=prefer"

5. 重置数据库初始化状态（终极方案） #

如果PersistentVolume中存储的是之前用MD5认证初始化的旧数据，即使修改配置也无法更新密码哈希，需清空数据后重新部署：

• 先删除StatefulSet和PV（注意备份数据）：

kubectl delete statefulset postgres
kubectl delete pv postgres-pv

• 重新创建PV和StatefulSet，若使用PostgreSQL 10-13版本，需添加环境变量强制用SCRAM初始化：

env:
  - name: POSTGRES_INITDB_ARGS
    value: "--auth-host=scram-sha-256"

内容的提问来源于stack exchange，提问作者Sercan Noyan Germiyanoğlu