升级Docker Desktop后kubectl报apiVersion v1alpha1无效如何解决

Kubernetes 从1.24版本开始正式移除了对exec认证插件client.authentication.k8s.io/v1alpha1 API版本的支持，升级Docker Desktop时会同步升级内置捆绑的kubectl二进制到1.24+版本，旧kubeconfig中残留的v1alpha1版本认证配置无法通过新版本kubectl的校验，就会抛出该错误。

• 找到本地kubeconfig配置文件，默认路径为：
  • Linux/macOS：~/.kube/config
  • Windows：%USERPROFILE%\.kube\config
• 打开配置文件，定位到users字段下对应目标集群用户的exec配置块，将块内的apiVersion: client.authentication.k8s.io/v1alpha1直接修改为apiVersion: client.authentication.k8s.io/v1beta1，其余配置项保持原样即可。两个API版本的配置结构无破坏性变更，绝大多数场景下直接替换版本号即可正常兼容。
• 若修改版本号后仍报错，分场景处理：
  • 对接云托管Kubernetes集群（EKS/ACK/TKE等）时，升级对应云厂商提供的集群认证客户端工具到最新版本，重新生成kubeconfig覆盖旧文件即可。
  • 对接Docker Desktop本地内置Kubernetes集群时，可打开Docker Desktop的Kubernetes设置页，选择重置本地Kubernetes集群，重置完成后会自动生成适配当前kubectl版本的全新配置，注意该操作会清空本地集群存储的所有工作负载、配置和数据。
• 配置修改完成后保存文件，执行kubectl version验证，命令正常返回客户端、服务端版本信息即代表修复完成。

不推荐通过降级kubectl版本的方式临时规避问题，低版本kubectl对接高版本Kubernetes集群会触发更多API兼容问题。

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