配置kubectl关联Docker Desktop遇配置缺失及连接失败问题

错误现象 #

执行kubectl config get-contexts时，出现配置文件找不到的警告，且无法显示Docker Desktop作为上下文：

W0617 11:50:24.613103   12808 loader.go:222] Config not found: .kube/prod-k8s-clcreative-kubeconfig.yaml, .kube/civo-k8s_test_1-kubeconfig, .kube/k8s_test_1.yml CURRENT   NAME   CLUSTER   AUTHINFO   NAMESPACE

执行kubectl get nodes时，无法连接到Kubernetes API服务器：

W0617 11:59:41.048676 23252 loader.go:222] Config not found: .kube/prod-k8s-clcreative-kubeconfig.yaml, .kube/civo-k8s_test_1-kubeconfig, .kube/k8s_test_1.yml
E0617 11:59:43.396988 23252 memcache.go:265] couldn't get current server API group list: Get "http://localhost:8080/api?timeout=32s": dial tcp [::1]:8080: connectex: No connection could be made because the target machine actively refused it.
E0617 11:59:45.735625 23252 memcache.go:265] couldn't get current server API group list: Get "http://localhost:8080/api?timeout=32s": dial tcp [::1]:8080: connectex: No connection could be made because the target machine actively refused it.
E0617 11:59:48.104304 23252 memcache.go:265] couldn't get current server API group list: Get "http://localhost:8080/api?timeout=32s": dial tcp [::1]:8080: connectex: No connection could be made because the target machine actively refused it.
E0617 11:59:50.448120 23252 memcache.go:265] couldn't get current server API group list: Get "http://localhost:8080/api?timeout=32s": dial tcp [::1]:8080: connectex: No connection could be made because the target machine actively refused it.
E0617 11:59:52.773207 23252 memcache.go:265] couldn't get current server API group list: Get "http://localhost:8080/api?timeout=32s": dial tcp [::1]:8080: connectex: No connection could be made because the target machine actively refused it.
Unable to connect to the server: dial tcp [::1]:8080: connectex: No connection could be made because the target machine actively refused it.

已尝试操作 #

• 重启Docker Desktop中的Kubernetes组件
• 以管理员权限运行终端执行命令

解决步骤 #

1. 清除自定义KUBECONFIG环境变量 #

错误提示找不到指定的配置文件，说明kubectl被环境变量KUBECONFIG指定了不存在的配置路径。执行以下命令：

# 查看当前KUBECONFIG设置
echo $KUBECONFIG
# 清除该环境变量
unset KUBECONFIG

之后再执行kubectl config get-contexts，kubectl会默认读取~/.kube/config文件。

2. 确保Docker Desktop生成的配置已合并到默认文件 #

Docker Desktop启用Kubernetes后，会自动将配置合并到~/.kube/config。如果没有，手动操作：
打开Docker Desktop设置 → Kubernetes → 点击Copy kubeconfig按钮，将复制的内容追加到本地~/.kube/config文件末尾。

3. 切换到Docker Desktop上下文 #

执行命令查看所有可用上下文：

kubectl config get-contexts

找到名为docker-desktop的上下文，执行切换命令：

kubectl config use-context docker-desktop

此时再执行kubectl get nodes，应该能看到Docker Desktop的Kubernetes节点信息。

4. 验证版本兼容性 #

kubectl客户端版本与Docker Desktop的Kubernetes服务端版本差异过大也会导致连接问题：

• 查看kubectl客户端版本：kubectl version --client
• 在Docker Desktop设置的Kubernetes页面查看服务端版本
  确保两者版本差异不超过一个大版本（例如v1.28和v1.27兼容，v1.28和v1.25可能出现问题）。

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