EKS集群创建后无法用kubectl连接：ExecCredential版本注册错误

问题根源 #

该错误是kubectl版本与EKS集群认证API版本不兼容导致的：

• 你使用的eksctl 0.111.0属于较新版本，创建的集群会采用client.authentication.k8s.io/v1alpha1版本的ExecCredential进行身份认证
• 若本地kubectl版本过低（比如低于v1.20），无法识别该API版本，就会触发此错误

解决步骤 #

1. 检查本地kubectl版本 #

先确认当前kubectl客户端版本：

kubectl version --client

如果版本低于v1.20，必须进行升级。

2. 升级kubectl到兼容版本 #

根据操作系统选择对应升级方式：

• Linux：

  curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
  chmod +x ./kubectl
  sudo mv ./kubectl /usr/local/bin/kubectl
  

• macOS（Homebrew）：

  brew upgrade kubectl
  

• Windows（Chocolatey）：

  choco upgrade kubernetes-cli
  

升级后再次验证版本，确保客户端版本与EKS集群版本差距在1个大版本以内（比如集群是v1.24，kubectl用v1.23/1.24/1.25均可）。

3. 更新kubeconfig配置 #

重新生成并加载正确的集群配置：

aws eks update-kubeconfig --region ap-south-1 --name basic-cluster

执行后运行以下命令验证连通性：

kubectl get nodes

4. 升级aws-cli（可选） #

如果本地aws-cli版本过旧，aws eks get-token返回的认证格式也可能不兼容，执行升级：

pip install --upgrade awscli

额外排查项 #

• 若使用aws-iam-authenticator而非aws-cli的get-token功能，需将aws-iam-authenticator升级到最新版本
• 确认本地AWS凭证配置正确（~/.aws/credentials或环境变量），可通过aws sts get-caller-identity验证身份有效性

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