首页/云/Kubernetes 速查/ImagePullBackOff 与 ErrImagePull
本包目录(307 条)
kubectl 基础56 条工作负载36 条网络与服务55 条配置与存储54 条调度与资源52 条
集群运维与排障54 条

ImagePullBackOff 与 ErrImagePull

拉取镜像失败:ErrImagePull 是本次失败提示,ImagePullBackOff 是退避重试状态;原因集中在镜像名、仓库凭据与节点网络。

Kubernetes 速查云更新于 2026-10-12

排查

排查
kubectl describe pod web-x | grep -A8 'Events:'
kubectl get secret regcred -n prod -o jsonpath='{.type}'
# 节点侧手工验证(只做拉取测试)
crictl pull registry.example.com/app:1.26.0
私有仓库建 docker-registry 类型 Secret,并在 Pod 模板里引用 imagePullSecrets
镜像地址核对仓库主机名、项目路径与 tag,缺省 tag 按 latest 处理
网络与证书节点要能访问仓库;私有仓库证书需被节点信任
401/403 多为凭据无效或未授权;manifest unknown 是名字或 tag 不存在;x509 报错指向证书信任。

易错点

  • Secret 建在别的命名空间:imagePullSecrets 只对本命名空间的对象生效
  • 只在手工 Pod 上试通:Deployment 模板里没写凭据,新副本依旧拉不动

数据来源与参考

  • Kubernetes 官方文档 · 拉取私有镜像
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌