K8s配置PostgreSQL报错：角色'amigoscode'不存在求助

问题现象 #

启动Postgres Pod后连接报错：

psql: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: FATAL: role "amigoscode" does not exist

现有配置 #

ConfigMap 配置 #

apiVersion: v1
kind: ConfigMap
metadata:
  name: postgres-config
data:
  POSTGRES_DB: amigoscode
  POSTGRES_USER: amigoscode
  POSTGRES_PASSWORD: password

StatefulSet 配置 #

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: postgres
  labels:
    app: postgres
spec:
  serviceName: postgres
  replicas: 1
  template:
    metadata:
      name: postgres
      labels:
        app: postgres
    spec:
      volumes:
        - name: postgres
          persistentVolumeClaim:
            claimName: postgres-pc-volume-claim
      containers:
        - name: postgres
          image: postgres
          imagePullPolicy: IfNotPresent
          volumeMounts:
            - mountPath: "/var/lib/postgresql/data"
              name: postgres
          envFrom:
            - configMapRef:
                name: postgres-config
          resources:
            requests:
              cpu: 100m
              memory: 256Mi
            limits:
              cpu: 500m
              memory: 512Mi
      restartPolicy: Always
  selector:
    matchLabels:
      app: postgres

部署命令：kubectl apply -f <folder_name>

问题原因与解决方法 #

核心原因 #

PostgreSQL官方镜像的初始化逻辑是仅在首次启动且数据目录（/var/lib/postgresql/data）为空时，才会读取POSTGRES_USER、POSTGRES_DB等环境变量创建对应角色和数据库。如果你的PersistentVolume中已经存在之前未正确初始化的旧数据，后续启动Pod时不会重新执行初始化流程，导致配置的角色不存在。

解决步骤 #

1. 清理现有存储资源
   删除对应的PersistentVolumeClaim，连带清理关联的PersistentVolume数据：

   kubectl delete pvc postgres-pc-volume-claim
   

2. 删除现有StatefulSet

   kubectl delete statefulset postgres
   

3. 重新部署
   执行原部署命令，让PostgreSQL重新初始化：

   kubectl apply -f <folder_name>
   

验证步骤 #

重新部署后，进入Pod验证环境变量是否正确注入：

kubectl exec -it <postgres-pod-name> -- env | grep POSTGRES

确认输出中包含POSTGRES_USER=amigoscode、POSTGRES_DB=amigoscode等配置，再尝试连接数据库即可正常访问。

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