Windows11下Docker+Kubernetes切换上下文时出现dial tcp [::1]:8080错误

问题核心 #

出现如下错误的根本原因是新上下文的kubeconfig配置未正确指向Docker Desktop内置的Kubernetes集群地址：

Unable to connect to the server: dial tcp [::1]:8080: connectex: No connection could be made because the target machine actively refused it.

解决方案步骤 #

1. 检查并修正新上下文的集群地址 #

• 执行命令查看新上下文的详细配置：

  kubectl config view --minify --context=你的新上下文名称
  

• 确认输出中的server字段是否为https://kubernetes.docker.internal:6443（Docker Desktop Kubernetes默认地址）。如果显示为http://localhost:8080，执行以下命令修正：

  kubectl config set-cluster docker-desktop --server=https://kubernetes.docker.internal:6443
  

2. 确保新上下文绑定正确的集群与用户 #

• 查看所有上下文的绑定关系：

  kubectl config get-contexts
  

• 检查新上下文对应的CLUSTER和USER列是否与docker-desktop上下文一致。若不一致，执行绑定命令：

  kubectl config set-context 你的新上下文名称 --cluster=docker-desktop --user=docker-desktop
  

3. 验证Docker Desktop Kubernetes服务状态 #

• 打开Docker Desktop设置面板，确认Kubernetes选项已勾选，且状态显示为Running。
• 若服务状态异常，重启Docker Desktop，等待Kubernetes完全启动后再切换上下文测试。

4. 重建无效上下文 #

• 若上述步骤无效，先删除错误上下文：

  kubectl config delete-context 你的新上下文名称
  

• 基于正常的docker-desktop上下文创建新上下文（可指定目标命名空间）：

  kubectl config set-context 新上下文名称 --cluster=docker-desktop --user=docker-desktop --namespace=你的目标命名空间
  

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