挂载超时需先确认Events中是否有FailedMount及timeout expired字样；若仅有FailedAttachVolume则属attach超时。检查节点Ready状态、kubelet日志，并通过事件时间戳链路或手动验证设备存在性区分attach与mount超时，再针对性排查存储服务、CSI驱动及节点资源瓶颈。
确认挂载超时是否真实发生
先看 Events 是否明确出现 FailedMount 且带 timeout expired waiting for volumes to attach or mount 字样：执行 kubectl describe pod <pod-name> -n <namespace>，重点扫描 Events 区域最后一段——若只有 FailedAttachVolume 而无 FailedMount，说明卡在卷绑定阶段，不是挂载超时。
检查 Pod 所在节点是否 Ready：运行 kubectl get node <node-name>，如果状态不是 Ready，kubelet 可能已停止上报心跳，导致卷挂载流程根本无法启动。
查看 kubelet 日志中是否有挂载超时线索：登录对应工作节点，执行 journalctl -u kubelet -n 200 --no-pager | grep -i "mount.*timeout\|volume.*wait\|attach.*timeout"。注意：【超时阈值默认为6分钟，由 kubelet 的 --volume-plugin-dir 和 --enable-controller-attach-detach 共同影响，不可 runtime 修改】。
区分是 attach 超时还是 mount 超时
方法一：查事件时间戳链路
在 kubectl describe pod 输出中，逐行比对 Events 时间线：
① 若 FailedAttachVolume 出现在 FailedMount 之前（早于 30 秒以上），且报错含 AttachVolume.Attach failed，说明卡在存储后端设备挂载到节点这步，属于 attach 超时；
② 若 FailedMount 紧跟在 SuccessfulAttachVolume 之后（间隔＜10 秒），但后续无进一步日志，说明设备已 attach 成功，但容器内 mount 操作失败或阻塞，属 mount 超时。
方法二：直接验证设备是否存在
登录 Pod 所在节点 → 进入 kubelet 卷插件目录：ls /var/lib/kubelet/plugins/kubernetes.io/<driver-name>/（如 rbd、nfs、csi-hostpath）→ 查看对应 PV ID 目录下是否有 mounts/ 子目录及其中的挂载点路径。若该目录为空或不存在，大概率是 attach 阶段未完成；若存在但 findmnt -t <fstype> | grep <pv-id> 无输出，说明 mount 操作被阻塞或失败。
针对 attach 超时的快速定位
第一步：确认底层存储服务可达
若为 NFS：在节点上执行 showmount -e <nfs-server-ip>，失败则说明网络不通或 NFS 服务宕机；
若为 Ceph RBD：执行 rbd status <pool>/<image>，返回 error opening image 表示镜像损坏或权限不足；
若为云盘（EBS/EVS）：登录云控制台，确认磁盘状态是否为 in-use 且绑定到当前节点实例 ID。
第二步：检查 CSI 驱动健康状态
运行 kubectl get csidriver 确认驱动对象存在 → 执行 kubectl get pods -n <csi-namespace> | grep controller，确保 controller pod 处于 Running 状态 → 查看其日志：kubectl logs -n <csi-namespace> <controller-pod> -c csi-controller，搜索 Attach 关键字，常见错误如 rpc error: code = DeadlineExceeded 直接指向 attach 超时。
第三步：排查节点级资源瓶颈
执行 df -h /var/lib/kubelet，若使用率 ≥95%，kubelet 会拒绝创建新挂载点；
运行 lsof +D /var/lib/kubelet/pods，若返回数千行结果，说明 inode 耗尽，需清理残留 pod 目录；
【特别注意：若节点磁盘 I/O wait % 持续高于 80（用 iostat -x 1 查看），attach 请求会被内核层延迟，触发 kubelet 超时】。
针对 mount 超时的现场验证
登录 Pod 所在节点 → 手动模拟挂载流程：
① 获取 PV 对应的设备路径：从 kubectl get pv <pv-name> -o yaml 中提取 spec.rbd.image 或 spec.nfs.path；
② 尝试本地挂载：例如 NFS 场景下执行 mkdir -p /tmp/test-mount && mount -t nfs4 -o vers=4.1,hard,intr <nfs-server>:/path /tmp/test-mount；
③ 若手动挂载卡住超过 30 秒，基本可断定是网络策略、NFS 服务器负载或防火墙拦截所致。
检查挂载选项兼容性：
在 PV 定义中查看 spec.mountOptions，若含 soft 选项，NFS 客户端会在超时后返回错误而非挂起，此时不应出现 mount 超时；若含 hard,intr 却无响应，说明服务端已无响应能力。
验证容器运行时权限：
若 PV 类型为 hostPath 或 local，且 Pod 设置了 securityContext.privileged: true，需确认节点 SELinux 状态：getenforce 返回 Enforcing 时，即使 privileged 为 true，某些挂载操作仍被拦截；临时测试可执行 setenforce 0 后重启 Pod，若恢复则需配置正确 SELinux 策略。
