csi-mount-failed

CSI 挂载失败

现象

Pod 卡在 ContainerCreating，事件显示 MountVolume.SetUp failed、failed to mount、no such device 或 timeout expired waiting for volumes to attach/mount；PVC 处于 Pending 或挂载超时。

快速定位

kubectl describe pod <POD> -n <NS> | grep -A30 Events
kubectl get pvc,pv -n <NS>
kubectl -n kube-system get pods | grep csi
kubectl -n kube-system logs <CSI_NODE_POD> --tail=100

节点上检查挂载：

mount | grep <PVC>
dmesg | tail -50
lsblk

常见根因

• CSI Controller/Node 插件未就绪或权限不足。
• StorageClass 的 provisioner 名称错误。
• 后端存储不可达、凭据错误或配额不足。
• 节点缺少挂载依赖（NFS 客户端、iSCSI、FUSE）。
• 卷被其他节点挂载，ReadWriteOnce 冲突。
• 文件系统损坏或设备未格式化。

修复

• 检查 CSI Pod 日志和 RBAC。
• 确认 StorageClass、Secret 和存储后端配置。
• 在节点安装缺失的挂载工具。
• 清理残留的 VolumeAttachment 和挂载点。
• 修复文件系统或重新创建 PV。
• 仍无法恢复时，备份数据后重建 PVC。

相关命令

• kubectl describe pod — 挂载事件
• kubectl get pvc,pv — 存储状态
• kubectl logs — CSI 日志
• mount / lsblk / dmesg — 节点挂载
• csi — 存储插件