Kubernetes PersistentVolumeClaim stuck in Pending ('no persistent volumes available for this claim and no storage class is set', 'waiting for first consumer to be created before binding'). Causes and fixes

Cause: a claim binds only when a matching volume exists or a StorageClass can provision one. Common reasons: (a) the cluster has no default StorageClass and the claim names none; (b) the claim sets storageClassName: "" which disables dynamic provisioning, so it waits for a manually created PV; (c) the StorageClass uses volumeBindingMode: WaitForFirstConsumer, so the claim stays Pending by design until a pod that uses it is scheduled; (d) no static PV matches the requested size, access mode or class; (e) the provisioner or CSI driver is missing or failing. Fix (best first): 1. Read the events: kubectl describe pvc CLAIM_NAME -n NAMESPACE. They usually state which of the cases above applies. 2. If the event says it is waiting for first consumer, that is normal. Create or fix the pod that mounts the claim; the volume is provisioned after the pod is scheduled. If the pod itself is Pending, debug that (scheduling, zone, capacity). 3. List classes: kubectl get storageclass. If none is marked (default), either set storageClassName in the claim to an existing class, or mark one as default with the annotation storageclass.kubernetes.io/is-default-class: "true". Keep only one default. 4. Remove storageClassName: "" from the claim unless you really intend to bind a pre-created PV. For static PVs, make sure class, capacity (at least the request) and access modes match. 5. If a class is set but nothing is created, check that the provisioner (for example the cloud's CSI driver) is installed and its controller pods are healthy: kubectl get pods -n kube-system, and read their logs. 6. Check cloud quota and zone constraints if provisioning errors appear in the events. Verify: kubectl get pvc shows STATUS Bound and a VOLUME name, and the pod mounting it reaches Running. Sources: https://kubernetes.io/docs/concepts/storage/persistent-volumes/ https://kubernetes.io/docs/concepts/storage/storage-classes/