执行az aks get-credentials命令遇ControlPlaneNotFound错误求助

1. 验证AKS集群的存在状态 #

执行以下命令确认目标集群是否存在、状态是否正常：

az aks list --resource-group myResourceGroup --output table

如果列表里看不到myAKSCluster，说明集群可能已被删除，或者资源组名称输入错误。

2. 检查资源组和集群名称的拼写 #

确认命令中的资源组myResourceGroup和集群名myAKSCluster完全正确，包括大小写（Azure资源名称区分大小写）。可以通过以下命令列出当前订阅下的所有资源组：

az group list --output table

3. 确认当前Azure订阅正确 #

如果账号有多个Azure订阅，可能默认订阅不是集群所在的订阅，执行以下命令切换到正确订阅：

# 查看当前订阅
az account show
# 列出所有订阅
az account list --output table
# 切换到目标订阅
az account set --subscription <你的订阅ID或名称>

4. 检查集群是否处于异常状态 #

如果集群存在但状态异常（比如正在删除、升级失败），也会触发该错误。执行以下命令查看集群详细状态：

az aks show --resource-group myResourceGroup --name myAKSCluster

重点关注provisioningState字段，正常状态应为Succeeded。如果状态异常，需要先修复集群状态（比如重新创建或联系Azure支持）。

5. 清理本地kubeconfig并重新获取 #

本地.kube/config可能存在旧的无效配置，先备份再清理，重新获取凭证：

# 备份当前配置
cp ~/.kube/config ~/.kube/config.bak
# 删除旧的AKS集群配置条目
kubectl config delete-cluster myAKSCluster
kubectl config delete-context myAKSCluster
kubectl config delete-user clusterUser_myResourceGroup_myAKSCluster
# 重新获取凭证
az aks get-credentials --resource-group myResourceGroup --name myAKSCluster --overwrite-existing

6. 排除minikube的干扰 #

minikube的本地集群配置可能和AKS配置冲突，暂时停用minikube：

minikube stop
minikube delete

之后再重新执行az aks get-credentials命令测试。

内容的提问来源于stack exchange，提问作者ASIT KUMAR ROUT