容器与云原生 / 系统课时
理解 PVC 与 PV 状态迁移
理解 PVC 与 PV 状态迁移
PVC 与 PV 都有 status.phase,但两者的状态集合和含义并不相同。本课把 phase、双向引用和事件放在同一条证据链上,帮助你判断卷是尚未绑定、已经释放、回收失败,还是绑定完成后卡在更下游。
学习目标
- 区分 PVC 与 PV 的常见 phase,避免混淆
Released、Failed与Lost。 - 用
kubectl同时检查 phase、volumeName、claimRef和事件。 - 根据
Pending、Released、Failed等现象切换到正确的排障边界。
先分清两套状态
PVC 常见 phase 为 Pending、Bound 和 Lost;PV 常见 phase 为 Available、Bound、Released 和 Failed。因此,Released 与 Failed 是 PV 状态,不是 PVC 状态;Lost 则属于 PVC。
| 对象 | phase | 含义 |
|---|---|---|
| PVC | Pending |
尚未完成与某个 PV 的绑定 |
| PVC | Bound |
已与 PV 建立控制面绑定 |
| PVC | Lost |
曾经绑定,但对应 PV 已不存在或无法再找到 |
| PV | Available |
可供 Claim 绑定 |
| PV | Bound |
已绑定到 Claim |
| PV | Released |
原 Claim 已删除,但卷尚未完成回收或重新可用 |
| PV | Failed |
自动回收流程失败 |

用 kubectl 建立状态快照
先从 PVC 找到它引用的 PV,再检查 PV 是否反向指回同一个 Claim。下面把 <PVC> 替换为实际名称;如果 PVC 不在当前命名空间,为 PVC 和事件命令补上 -n <NAMESPACE>。
kubectl get pvc "<PVC>" \
-o custom-columns='PVC:.metadata.name,PHASE:.status.phase,PV:.spec.volumeName,SC:.spec.storageClassName'
PV_NAME="$(kubectl get pvc "<PVC>" -o jsonpath='{.spec.volumeName}')"
if [ -n "$PV_NAME" ]; then
kubectl get pv "$PV_NAME" \
-o custom-columns='PV:.metadata.name,PHASE:.status.phase,CLAIM_NS:.spec.claimRef.namespace,CLAIM:.spec.claimRef.name,RECLAIM:.spec.persistentVolumeReclaimPolicy'
fi已正常绑定时,预期结果应同时看到 PVC 与 PV 为 Bound,且 PVC 的 volumeName 与 PV 名称一致,PV 的 claimRef 反向指回同一个 Claim。
PVC PHASE PV SC
<PVC> Bound <PV_NAME> <STORAGECLASS>
PV PHASE CLAIM_NS CLAIM RECLAIM
<PV_NAME> Bound <NAMESPACE> <PVC> <POLICY>如果 PVC 仍为 Pending,spec.volumeName 往往为空;此时不要猜测 PV 名称,而应继续检查 PVC 事件、StorageClass 和调度条件。
用事件解释为什么没有继续迁移
phase 只能告诉你“现在在哪”,事件更适合回答“为什么停在这里”。PVC 绑定与动态供应问题优先看 PVC 事件;使用 WaitForFirstConsumer 时,还要看消费该 PVC 的 Pod 事件,因为调度器需要先确定可行节点与存储拓扑。
kubectl describe pvc "<PVC>"
kubectl get events \
--field-selector "involvedObject.kind=PersistentVolumeClaim,involvedObject.name=<PVC>" \
--sort-by=.metadata.creationTimestamp预期结果可能表现为等待消费者、动态供应进行中或供应失败。Reason 与 Source 会随 Kubernetes 版本、external-provisioner 和 CSI 驱动实现变化,应重点阅读 Message,而不是依赖固定事件名。
TYPE REASON OBJECT MESSAGE
Normal <WAIT_OR_PROVISIONING> persistentvolumeclaim/<PVC> <DETAIL>
Warning <BIND_OR_PROVISION_FAIL> persistentvolumeclaim/<PVC> <ERROR_DETAIL>没有可匹配 PV 时,检查容量、访问模式和 StorageClass;动态供应失败时继续检查 external-provisioner 与 CSI Controller;WaitForFirstConsumer 长期等待时,确认是否存在消费 Pod,并核对 Pod 的节点选择、亲和性和拓扑约束。
从引用关系判断 Released 与 Lost
PVC 为 Bound 时,两条引用应互相吻合:PVC 的 spec.volumeName 指向 PV,PV 的 spec.claimRef 指回 PVC。PV 进入 Released 后,旧 claimRef 通常仍保留,用来避免另一个 Claim 在数据处置完成前直接接管该卷。
Retain 策略下,删除 PVC 后看到 PV 停在 Released 往往是预期行为。管理员应先确认后端数据是保留、迁移还是删除,再决定删除并重建 PV,或在确认安全后执行受控复用。不要只为了改变状态就直接清除 claimRef。
PVC 的 Lost 是另一类信号:Claim 认为自己曾绑定过卷,但对应 PV 已不存在。此时先确认 PV 是否被误删,以及是否发生控制面恢复或迁移问题,再处理数据恢复;手工修改 PVC 的 status.phase 不能修复真实引用关系。
按状态切换排障边界
Pending 是绑定阶段最常见的阻塞状态。先看 PVC 事件,再检查 StorageClass、可匹配 PV 与消费 Pod,不要直接跳到节点 mount 链路。
Released 主要检查 PV 的 persistentVolumeReclaimPolicy 与 claimRef。Retain 下通常需要人工处置数据;如果预期 Delete 却长时间不消失,再检查供应器、CSI Controller、后端删除操作及阻止删除的保护机制。
Failed 表示 PV 自动回收失败,不是“Pod 挂载失败”的同义词。此时应查看 PV 事件,再结合存储供应器或 CSI Controller 日志定位后端回收错误。
修复后再次执行前面的状态快照命令,确认 phase 与两端引用符合预期;如果 PVC 与 PV 已为 Bound 但 Pod 仍不可用,应立即把排障边界切换到调度、attach 和 mount 链路。