如何修复Kubernetes应用资源时出现的wire-format数据错误？

我有如下deployment.yaml文件：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  selector:
    matchLabels:
      app: nginx
  replicas: 2 
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.14.2
        ports:
      - containerPort: 80

执行kubectl apply -f deployment.yaml时反复报错：error: proto: cannot parse invalid wire-format data。已经检查过缩进，把制表符换成了空格，但问题没解决。甚至用官方模板执行kubectl apply -f https://k8s.io/examples/application/deployment.yaml也出现同样错误。

1. 先修复YAML语法错误 #

你的deployment.yaml存在明显的缩进问题：ports字段下的containerPort没有正确缩进，它应该属于当前容器的配置项，和name、image保持同一层级。修正后的正确yaml如下：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  selector:
    matchLabels:
      app: nginx
  replicas: 2 
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.14.2
        ports:
        - containerPort: 80  # 这里缩进对齐到ports的子项级别

2. 排查kubectl与集群版本兼容性 #

如果修复yaml后还是报错，且官方模板也无法正常应用，大概率是kubectl客户端和Kubernetes集群版本不匹配导致的。Kubernetes官方要求客户端与服务器版本的差距不能超过一个小版本（比如v1.25的客户端可以兼容v1.24至v1.26的集群）。

• 检查本地kubectl版本：kubectl version --client
• 检查集群API服务器版本：kubectl version --short
  如果版本差过大，直接升级或降级kubectl到和集群匹配的版本即可。

3. 检查kubeconfig配置文件 #

kubeconfig文件损坏或配置异常也会触发这个proto解析错误：

• 先备份当前配置：cp ~/.kube/config ~/.kube/config.bak
• 重新获取集群的kubeconfig（比如从云服务商控制台下载，或者用kubeadm重新生成）
• 替换配置后再尝试执行kubectl apply命令。

4. 检查集群API服务器状态 #

如果以上方法都无效，就得排查集群本身的问题：

• 查看kube-system下的API服务器Pod状态：kubectl get pods -n kube-system | grep kube-apiserver
• 查看API服务器的日志：kubectl logs -n kube-system <kube-apiserver-pod-name>
  如果API服务器运行异常，需要先修复集群组件的问题才能继续操作。

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