Azure AKS环境下kubectl连接服务器失败问题求解

我之前在AKS环境里也碰到过一模一样的错误，本质是kubectl当前的配置没有指向你的AKS集群，而是默认尝试连接本地的Kubernetes节点（也就是localhost:8080），给你几个一步步的排查和解决步骤：

• 检查并切换kubectl上下文
  首先确认你当前的kubectl上下文是不是指向了AKS集群：

  kubectl config get-contexts
  

  输出里带*的是当前使用的上下文，如果不是你的AKS集群，用下面的命令切换：

  kubectl config use-context <你的AKS集群名称>
  

• 重新获取AKS的kubeconfig配置
  有时候本地的kubeconfig可能过期或者配置有误，用Azure CLI重新拉取最新的配置：

  az aks get-credentials --resource-group <你的资源组名称> --name <你的AKS集群名称>
  

  这个命令会自动把AKS的集群配置合并到你本地的~/.kube/config（Linux/macOS）或者C:\Users\<你的用户名>\.kube\config（Windows）文件里。

• 验证配置正确性
  查看当前上下文的详细配置，确认server地址不是localhost:8080：

  kubectl config view --minify
  

  正常情况下，server字段应该是AKS集群的API服务器地址，类似https://<cluster-name>-<random-string>.hcp.<region>.azmk8s.io:443。

• 测试网络连通性
  如果配置没问题但还是连接失败，检查本地网络能不能访问AKS的API服务器：
  Windows用户可以用：

  Test-NetConnection <AKS_API_SERVER_ADDRESS> -Port 443
  

  Linux/macOS用户用：

  telnet <AKS_API_SERVER_ADDRESS> 443
  

  如果连通失败，检查是否有防火墙规则、VPN或者代理阻止了443端口的访问，确保你的网络环境允许连接AKS的API端点。

• 确认版本兼容性
  kubectl和AKS集群的版本差不能超过一个小版本（比如集群是1.27，kubectl可以是1.26/1.27/1.28），版本不兼容也可能导致连接问题：
  查看客户端版本：

  kubectl version --client
  

  查看AKS集群版本：

  az aks show --resource-group <你的资源组名称> --name <你的AKS集群名称> --query kubernetesVersion
  

  如果版本差异过大，升级或降级kubectl到兼容版本即可。

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