首页/云/云与容器速查/ContainerCreating 卡住排查

ContainerCreating 卡住排查

Pod 调度完成但起不来:卡在挂卷、网络或镜像层。describe 的 Events 会指明卡点;CNI 故障、卷未挂上、镜像超大都能让它长时间停留。

云与容器速查云更新于 2026-10-13

ContainerCreating 卡住是什么情况

Pod 已经调度到节点却迟迟不是运行状态,停在 ContainerCreating,说明容器运行时在准备阶段卡住了。卡点集中在三处:挂卷失败、创建 Pod 沙箱也就是网络失败、镜像拉取慢或失败。事件会说明卡在哪一步,先读事件再动手,别急着删 Pod。

基本信息

常见事件挂载失败、创建沙箱失败、拉取镜像中
卷问题存储声明未绑定、挂载超时、卷被其他 Pod 占用
网络问题网络插件未就绪、IP 耗尽、网卡配置报错
镜像问题大镜像拉取慢,事件里能看到进度
节点侧用容器运行时命令行与 kubelet 日志看底层报错
判定线超过 5 分钟基本不是单纯慢

卡点与处置

事件关键词含义处置
挂载失败存储声明未绑定或挂载超时先查存储声明状态与存储插件
创建沙箱失败网络插件或 IP 资源不足查网络插件 Pod 与 IP 池
拉取镜像中镜像大或仓库慢看进度,必要时预热镜像
卷被占用单节点读写卷已被同节点其他 Pod 使用核对副本数与访问模式
节点压力节点正在驱逐或回收 Pod看节点状态与事件

排查命令

排查命令
kubectl describe pod web-1 | tail -25                              # 事件是关键
kubectl get pvc -n dev                                             # 存储声明是否绑定
kubectl get events --field-selector involvedObject.name=web-1 --sort-by=.lastTimestamp | tail
kubectl get pods -n kube-system | grep -Ei "cni|calico|flannel"     # 网络插件是否就绪

典型使用场景

  • 新副本长时间不起,需要区分是挂卷、网络还是镜像问题
  • 节点重启后网络插件未就绪,新 Pod 全部卡在创建阶段
  • 大镜像首次拉取很慢,需要判断是正常等待还是卡死
  • 有状态服务的卷被占用,新 Pod 无法完成挂载
超过 5 分钟还停在创建阶段,基本可排除只是慢:按卷、网络、镜像的顺序逐项看事件,比反复删除重建有效得多。
节点侧信息比集群侧更具体:用容器运行时命令行看容器状态、查 kubelet 日志,能拿到真正失败的底层原因。
反复删除重建不会解决卷被占用的问题:旧 Pod 的卷没释放时,新 Pod 依然会卡在同一位置。

易错点

  • 重复删除重建:卷占用没释放,新 Pod 仍卡同一位置
  • 忽略存储声明处于未绑定:卷没绑上,Pod 永远等不到挂载
  • 只看 Pod 不看节点日志:底层报错只在节点侧可见
  • 网络插件未就绪就大批滚动更新:新副本全部卡住
  • 把镜像大当卡死:不看事件进度就中断重建,白等一轮

数据来源与参考

  • Kubernetes Docs:Debugging Pods
  • Kubernetes Docs:Troubleshooting kubectl

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌