kubectl连接问题：遭遇localhost:8080连接拒绝错误

可能的故障原因 #

• kubectl未正确加载目标kubeconfig文件，默认尝试连接本地集群（localhost:8080）
• 当前上下文配置存在隐性不匹配，比如上下文关联的集群/用户信息有误
• AWS身份凭证失效或未获得EKS集群的访问权限
• kubeconfig文件权限不符合要求，导致kubectl无法读取
• 环境变量KUBECONFIG覆盖了默认配置路径，指向的文件无效

分步排障建议 #

1. 确认kubectl使用的kubeconfig路径 #

执行命令查看当前生效的kubeconfig路径：

echo $KUBECONFIG

如果输出为空，kubectl默认读取~/.kube/config；如果有其他路径，需确认该路径下的配置正确性。也可以手动指定路径测试：

kubectl version --kubeconfig=~/.kube/config

如果此命令正常返回版本信息，说明默认配置加载存在异常，检查环境变量是否被错误设置。

2. 验证上下文配置有效性 #

列出所有可用上下文：

kubectl config get-contexts

确认带*标记的当前上下文是目标EKS集群的上下文。若不是，切换到正确上下文：

kubectl config use-context <你的EKS上下文名称>

进一步检查上下文对应的集群和用户配置：

kubectl config view --minify --context=<你的EKS上下文名称>

重点确认server字段是EKS集群的正确Endpoint，certificate-authority-data非空，user关联的AWS身份配置无误。

3. 校验AWS身份凭证与集群权限 #

首先用AWS CLI测试凭证有效性：

aws eks describe-cluster --name <你的EKS集群名称>

若返回集群信息，说明凭证有效；若报错，检查IAM权限策略是否包含eks:DescribeCluster等必要权限，同时确认凭证未过期。

另外，EKS要求IAM实体（用户/角色）必须被添加到集群的aws-auth ConfigMap中才能访问。通过有权限的账号查看该配置：

kubectl get configmap aws-auth -n kube-system -o yaml

确认你的IAM用户ARN或角色ARN已被添加到mapUsers或mapRoles字段中。

4. 修正kubeconfig文件权限 #

kubeconfig文件权限必须设为600，否则kubectl会拒绝读取：

chmod 600 ~/.kube/config

同时确保文件所有者为当前用户，避免权限不足问题。

5. 测试集群Endpoint的网络连通性 #

用curl直接测试EKS集群Endpoint，需携带kubeconfig中的证书：

curl --cacert <(echo "<你的certificate-authority-data内容>" | base64 -d) https://<你的EKS集群Endpoint>/version

若返回JSON格式的版本信息，说明网络和证书正常；若报错，检查本地网络是否能访问EKS Endpoint（比如是否在VPC内、是否有防火墙/代理拦截）。

6. 重置kubectl配置缓存 #

有时kubectl会缓存旧配置，执行以下命令重置：

kubectl config unset current-context
kubectl config use-context <你的EKS上下文名称>

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