k8s-pv-resize

Kubernetes PVC 扩容卡住的定位与修复

现象

修改 PVC 的 resources.requests.storage 后，状态一直显示 Resizing 或容量不变；Pod 仍看到旧的文件系统大小。常见于 StorageClass 或 CSI 不支持在线扩容。

快速定位

kubectl get pvc <pvc> -n <ns> -o yaml
kubectl describe pvc <pvc> -n <ns>
kubectl get storageclass <sc> -o yaml | grep allowVolumeExpansion
kubectl get events -n <ns> --sort-by=.lastTimestamp | tail -20
kubectl logs -n <csi-ns> <csi-controller-pod> --tail=100

常见根因

1. StorageClass 未设置 allowVolumeExpansion: true。
2. CSI 驱动/存储后端不支持在线扩容。
3. 文件系统扩容需要重启 Pod（某些驱动）。
4. 存储配额或云盘容量达到上限。
5. 旧 PVC/PV 由静态供应，容量不可变。

修复

• 先确认 StorageClass 允许扩容，再修改 PVC。
• 查 CSI controller 日志和 Events，确认卡在哪个阶段。
• 需要重启 Pod 的驱动，按文档重建 Pod 触发文件系统扩容。
• 云盘/存储配额不足时先扩容后端或清理。
• 静态 PV 可能需要手动调整 PV 和存储后端。
• 扩容后进入 Pod 用 df -h 确认文件系统大小。

相关命令

• kubectl — PVC/PV/StorageClass
• k8s 分支的 pvc / csi 页面 — 存储细节
• df — 容器内文件系统