Docker Desktop Kubernetes无法使用本地镜像问题排查

我之前在Docker Desktop的K8s集群里遇到过完全一样的问题，结合你的配置和报错信息，咱们一步步分析原因并解决：

核心原因分析 #

ErrImageNeverPull错误的本质是：Kubernetes按照你设置的imagePullPolicy: Never，尝试使用本地节点上的镜像，但找不到完全匹配名称和标签的镜像，或者集群节点根本访问不到你本地构建的镜像。

具体排查和解决步骤 #

1. 确认镜像名称和标签完全匹配 #

你的YAML里image字段只写了镜像名（比如incremental-flask），没有指定标签，Kubernetes默认会补全为:latest，但有时候会因为标签匹配问题导致识别失败。

• 修改你的Deployment YAML，给image字段明确加上:latest标签：

  # 第一个Deployment的容器配置
  - name: incremental-flask-app
    image: incremental-flask:latest
    imagePullPolicy: Never
  # 第二个Deployment的容器配置
  - name: incremental-external-api
    image: incremental-external-api:latest
    imagePullPolicy: Never
  

• 重新应用配置：

  kubectl apply -f your-yaml-file.yaml
  

2. 检查Docker上下文是否正确 #

如果你的镜像构建在了非Docker Desktop的Docker daemon（比如minikube的daemon）里，Docker Desktop的K8s集群是看不到这个镜像的：

• 查看当前Docker上下文：

  docker context ls
  

  确保当前激活的上下文是desktop-linux（Mac环境下）或者对应Docker Desktop的上下文。
• 如果不是，切换到正确的上下文：

  docker context use desktop-linux
  

• 重新构建镜像（确保镜像存在于Docker Desktop的daemon中）：

  docker build -t incremental-flask:latest .
  docker build -t incremental-external-api:latest .
  

3. 查看Pod事件获取更详细的错误 #

用kubectl describe查看Pod的具体事件，能帮你定位更精准的问题：

kubectl describe pod incremental-api-deployment-98b5d7c95-bmqbf

在输出的Events部分，你会看到类似“failed to find local image: incremental-flask:latest”的提示，这直接说明镜像在节点上不存在，或者名称/标签不匹配。

4. 尝试替换imagePullPolicy为IfNotPresent #

如果Never策略还是有问题，可以暂时换成IfNotPresent——这个策略会优先使用本地镜像，只有本地没有的时候才尝试拉取：

imagePullPolicy: IfNotPresent

重新应用配置后，Kubernetes会正确识别本地已存在的镜像。

5. 重启Docker Desktop和Kubernetes集群 #

有时候Docker Desktop的K8s会有缓存问题，重启一下就能解决：

• 打开Docker Desktop设置，进入Kubernetes选项卡，先取消勾选“Enable Kubernetes”，应用后再重新勾选，等待集群重启完成。
• 或者直接重启Docker Desktop应用。

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