本地部署微服务时报pod has unbound immediate PersistentVolumeClaims错误如何解决

排查解决步骤 #

• 第一步：确认PV与PVC绑定状态
  执行以下命令查看资源状态：

  kubectl get pvc service-1-db-pvc
  kubectl get pv service-1-db-pv
  

  若STATUS列不是Bound状态，执行kubectl describe pvc service-1-db-pvc查看Events字段的报错信息，可直接定位绑定失败原因。
  若状态为Bound但仍提示未绑定，大概率是skaffold状态同步延迟，可忽略提示，或重启skaffold重新部署。
• 第二步：修复hostPath路径权限
  你使用的hostPath类型PV，路径为WSL的/mnt/wsl/service-1-pv，MongoDB镜像默认使用UID/GID为999的用户运行，需要给目录赋予对应权限：

  # 先手动创建目录避免自动创建时权限异常
  sudo mkdir -p /mnt/wsl/service-1-pv
  # 赋予MongoDB用户读写权限
  sudo chown -R 999:999 /mnt/wsl/service-1-pv
  sudo chmod 755 /mnt/wsl/service-1-pv
  

  如果你使用Minikube部署K8s，需要先将WSL目录挂载到Minikube节点内：

  minikube mount /mnt/wsl/service-1-pv:/mnt/wsl/service-1-pv
  

• 第三步：排查StorageClass冲突
  你当前PV和PVC的storageClassName均设为空字符串，若集群存在默认StorageClass，可能会抢占PVC的绑定逻辑。可以手动指定统一的StorageClass名避免冲突，在PV和PVC的spec中都添加如下配置：

  storageClassName: "local-mongo-pv"
  

• 第四步：添加PV节点亲和性规则
  hostPath类型的PV默认仅绑定到创建资源所在的节点，若Pod被调度到其他节点会找不到PV。可在PV的spec中添加节点亲和性，强制PV绑定到本地WSL节点：
  先获取本地节点名：

  kubectl get nodes -o jsonpath='{.items[0].metadata.name}'
  

  再修改PV配置，新增nodeAffinity字段：

  spec:
    # 原有配置保持不变
    nodeAffinity:
      required:
        nodeSelectorTerms:
        - matchExpressions:
          - key: kubernetes.io/hostname
            operator: In
            values:
            - 替换为上一步获取的节点名
  

• 第五步：清理残留资源后重新部署
  若之前部署过相同名称的PV/PVC，可能存在残留Finalizer导致绑定异常，先清理所有资源再重新部署：

  kubectl delete deployment deployment-service-1-db
  kubectl delete pvc service-1-db-pvc
  kubectl delete pv service-1-db-pv
  skaffold run --tail
  

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