Kubernetes部署PostgreSQL时指定数据库未自动创建求助

问题核心原因 #

PostgreSQL官方镜像的POSTGRES_DB环境变量仅在首次启动且数据目录为空时触发初始化逻辑，用于创建默认数据库。如果你的StatefulSet对应的PVC已存在旧的PostgreSQL数据（比如之前未配置POSTGRES_DB就启动过实例，或复用了旧存储卷），后续修改环境变量不会重新执行初始化流程，自然不会自动创建目标数据库。

排查步骤 #

1. 验证环境变量是否正确注入Pod
   执行命令检查Pod内的环境变量，确认POSTGRES_DB配置是否生效：

   kubectl exec -it postgres-deployment-0 -- env | grep POSTGRES_DB
   

   若输出为空或值不符，检查StatefulSet的环境变量配置是否存在缩进错误、拼写错误。

2. 确认数据目录是否已初始化
   进入Pod查看数据目录内容，判断是否已有初始化数据：

   kubectl exec -it postgres-deployment-0 -- ls -la /var/lib/postgresql/data
   

   若目录下存在PG_VERSION、base等文件，说明数据目录已完成初始化，POSTGRES_DB变量不再生效。

解决方法 #

方法1：清理存储卷重新初始化（彻底解决，会丢失现有数据） #

如果无需保留现有数据，直接删除对应PVC和Pod，让StatefulSet重新创建新存储卷并执行初始化：

# 删除运行中的Pod
kubectl delete pod postgres-deployment-0
# 删除绑定的PVC
kubectl delete pvc postgres-storage-postgres-deployment-0

StatefulSet会自动重建PVC和Pod，此时空数据目录会读取POSTGRES_DB变量创建指定数据库。

方法2：手动创建数据库（保留现有数据） #

若需要保留现有数据，进入Pod手动创建目标数据库：

# 进入PostgreSQL命令行
kubectl exec -it postgres-deployment-0 -- psql -U postgres
# 创建数据库
CREATE DATABASE qr_auth;
# 验证创建结果
\l

执行完成后退出命令行即可。

方法3：添加初始化脚本（长期适配需求） #

如果需要后续启动时自动检查并创建数据库，可通过挂载初始化脚本到PostgreSQL的初始化目录实现：

1. 创建包含初始化逻辑的ConfigMap：

apiVersion: v1
kind: ConfigMap
metadata:
  name: postgres-init-scripts
data:
  init-db.sql: |
    CREATE DATABASE IF NOT EXISTS qr_auth;

2. 修改StatefulSet的容器配置，挂载该ConfigMap：

containers:
- name: postgres
  # 保留原有配置不变
  volumeMounts:
  - name: postgres-storage
    mountPath: /var/lib/postgresql/data
  - name: init-scripts
    mountPath: /docker-entrypoint-initdb.d/
volumes:
- name: init-scripts
  configMap:
    name: postgres-init-scripts

这样每次Pod启动时，PostgreSQL都会自动执行该脚本，确保目标数据库存在。

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