基于PostgreSQL initdb目录创建PVC后Pod重启报错：目录不存在求助

可能的原因及修复步骤 #

1. 修复挂载目录的权限与存在性 #

Kubernetes挂载PVC到/var/lib/pgsql/14/data时，虽会自动创建目录，但默认权限为root:root，而PostgreSQL要求该目录归postgres用户所有且权限为700。启动脚本直接执行initdb时，若目录权限不匹配，会触发类似"目录不存在"的权限错误。

修复方法：
在启动脚本开头添加目录初始化逻辑：

PGDATA="/var/lib/pgsql/14/data"
# 确保目录存在并设置正确权限
mkdir -p "$PGDATA"
chown postgres:postgres "$PGDATA"
chmod 700 "$PGDATA"
# 执行initdb
sudo -u postgres "$PGHOME/bin/initdb" --pgdata=$PGDATA

也可在Dockerfile中预先创建目录并配置权限，避免挂载后权限异常：

RUN mkdir -p /var/lib/pgsql/14/data && \
    chown postgres:postgres /var/lib/pgsql/14/data && \
    chmod 700 /var/lib/pgsql/14/data

2. 验证StatefulSet挂载配置完整性 #

检查StatefulSet配置是否存在拼写或逻辑错误：

• 确认PVC已成功创建并绑定到PV（通过kubectl get pvc查看状态为Bound）
• 核对volumeMounts的mountPath和volumes的claimName无拼写错误
• 若使用StatefulSet，推荐用volumeClaimTemplates自动生成PVC（单实例场景也适用），示例配置片段：

spec:
  template:
    spec:
      containers:
      - name: postgres
        image: your-custom-postgres-image
        volumeMounts:
        - name: postgres-data
          mountPath: /var/lib/pgsql/14/data
  volumeClaimTemplates:
  - metadata:
      name: postgres-data
    spec:
      accessModes: [ "ReadWriteOnce" ]
      resources:
        requests:
          storage: 10Gi

3. 避免重复执行initdb（优化） #

Pod重启时，若PVC已有PostgreSQL数据，重复执行initdb会报错。可在脚本中添加判断逻辑：

PGDATA="/var/lib/pgsql/14/data"
mkdir -p "$PGDATA"
chown postgres:postgres "$PGDATA"
chmod 700 "$PGDATA"

# 仅当数据未初始化时执行initdb
if [ ! -f "$PGDATA/PG_VERSION" ]; then
  sudo -u postgres "$PGHOME/bin/initdb" --pgdata=$PGDATA
fi

# 启动PostgreSQL服务
sudo -u postgres "$PGHOME/bin/postgres" -D "$PGDATA"

4. 排查Pod内目录状态 #

若问题仍存在，进入Pod直接检查：

kubectl exec -it your-postgres-pod -- bash
# 查看目录是否存在及权限
ls -ld /var/lib/pgsql/14/data
stat /var/lib/pgsql/14/data

同时通过kubectl describe pod your-postgres-pod查看挂载事件，确认PVC是否正常挂载。

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