K8s部署PostgreSQL资源创建正常但Pod报CreateContainerError如何解决

前置排查操作 #

先执行以下命令获取具体错误信息，定位根因：

• 查看Pod事件详情：kubectl describe pod postgres-78496cc865-85kt7，重点看Events字段的报错内容
• 查看容器启动日志：kubectl logs postgres-78496cc865-85kt7

常见原因及解决方法 #

1. 数据目录权限不足（最高发原因） #

官方PostgreSQL镜像默认使用UID=999、GID=999的postgres用户运行，而PV挂载的目录默认属主为root，postgres用户没有写入权限，会导致容器创建失败。
解决方法：
在Deployment的spec.template.spec层级添加安全上下文配置，指定容器运行身份和卷权限组：

spec:
  template:
    spec:
      securityContext:
        runAsUser: 999
        runAsGroup: 999
        fsGroup: 999
      containers:
        # 原有容器配置保持不变

如果你使用的是hostPath类型的PV，还需要在PV对应的节点上执行权限修改命令：

sudo chown 999:999 <PV对应的节点本地目录路径>
sudo chmod 700 <PV对应的节点本地目录路径>

2. 挂载目录非空 #

PV根目录默认会生成lost+found系统目录，而PostgreSQL要求数据目录必须为空才能初始化，会启动失败。
解决方法：
在volumeMount配置中添加subPath参数，指定使用PV内的子目录作为数据存储路径：

volumeMounts:
  - mountPath: /var/lib/postgresql/data 
    name: postgredb
    subPath: postgres-data

3. PVC未正常绑定 #

虽然资源创建返回成功，但PVC可能因为PV和PVC的存储类、访问模式、容量不匹配处于Pending状态，无法挂载到Pod。
解决方法：
执行kubectl get pvc postgres-pv-claim查看PVC状态，如果STATUS不是Bound，核对PV和PVC的配置参数是否匹配。

4. 镜像拉取失败 #

如果节点上没有缓存postgres:10.18镜像，且公网访问受限，会导致镜像拉取失败，部分场景下会显示为CreateContainerError。
解决方法：
登录节点手动执行docker pull postgres:10.18验证镜像是否可以正常拉取，拉取失败可以替换为国内镜像源的PostgreSQL镜像。

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