使用Docker Hub公共镜像部署Knative Service出现RevisionMissing错误求助

排查与解决方案 #

1. 镜像拉取故障排查

• 本地执行docker pull docker.io/你的镜像名:版本，验证Docker Hub镜像拉取是否正常。Docker Hub对匿名用户设置了单IP每6小时100次的拉取限额，触发限流时会出现拉取超时、请求拒绝，是触发ProgressDeadlineExceeded报错的最常见原因。
• 确认Docker Desktop代理配置已覆盖Kubernetes集群运行时：你可正常拉取gcr.io镜像说明本地配置了代理，需检查Docker Desktop设置中的代理规则是否同步生效到K8s容器运行时，避免拉取Docker Hub镜像时走直连被限速或拦截。
• 执行kubectl get pods -n 你的服务部署命名空间查看对应Revision的Pod状态，若返回ImagePullBackOff/ErrImagePull可直接确认是镜像拉取环节故障。公共镜像临时拉取失败的话，可给命名空间下的ServiceAccount绑定Docker Hub镜像拉取秘钥，或是手动将镜像拉取到本地后，把YAML中的imagePullPolicy改为Never，强制K8s使用本地镜像跳过拉取环节。

2. 容器运行合规性排查

• Docker Hub官方hello-world镜像为一次性执行镜像，启动输出内容后就会退出，不符合Knative Service要求的常驻Web服务属性，必然会出现启动失败。请确认你使用的自定义Docker Hub镜像为常驻运行的服务，且确实监听了配置中指定的3007端口。
• Knative默认会请求容器的/healthz路径做健康检查，若你的镜像没有开放该路径，需要在容器配置中自定义livenessProbe和readinessProbe规则，避免健康检查失败导致Pod被反复重建。

3. Knative配置规则排查

• 确认YAML中配置的Revision命名符合{服务名}-{自定义版本后缀}的规则，命名不匹配会导致Knative无法关联服务和版本，触发RevisionMissing报错。
• 检查当前命名空间的RBAC权限，确保knative-serving控制器有权限创建Pod、Revision等关联资源。

内容的提问来源于stack exchange，提问作者Vinay Cheguri