什么是 ImagePullBackOff？
在 Kubernetes 中，当你部署一个 Pod 时，如果容器镜像无法成功拉取，Pod 的状态会显示为 ImagePullBackOff。
这通常表示 kubelet 尝试从镜像仓库拉取指定镜像失败，并会不断重试（指数退避）。
常见原因
- 镜像名称拼写错误（包括大小写）
- 镜像标签不存在
- 私有镜像仓库需要认证但未配置
imagePullSecrets - 节点无法访问镜像仓库（网络问题或防火墙限制）
- Docker Hub 拉取频率限制（匿名用户）
排查步骤
- 运行
kubectl describe pod <pod-name>查看详细事件信息。 - 检查输出中是否有类似
Failed to pull image "...": rpc error: ...的错误。 - 确认镜像名称和标签是否正确：例如
nginx:1.25是否存在。 - 如果是私有仓库，确保已创建 Secret 并在 Pod 或 ServiceAccount 中引用。
- 在节点上手动执行
docker pull your-image测试拉取是否可行。
示例：配置 imagePullSecrets
# 创建 Secret
kubectl create secret docker-registry my-registry-secret \
--docker-server=<your-registry> \
--docker-username=<your-name> \
--docker-password=<your-pword>
# 在 Pod 中使用
spec:
containers:
- name: my-app
image: <your-registry>/my-app:latest
imagePullSecrets:
- name: my-registry-secret总结
ImagePullBackOff 是 Kubernetes 初学者常遇到的问题，但通过系统性排查（镜像名、网络、权限），绝大多数情况都能快速解决。
建议在 CI/CD 流程中加入镜像预检机制，避免部署失败。