Kubernetes集群接入Istio后GRPC调用报协议错误该如何解决

问题根因 #

Istio Sidecar默认会自动识别服务端口的通信协议，若未显式声明Kubernetes Service的端口协议为GRPC，Istio会将其默认识别为HTTP/1.1协议，而GRPC基于HTTP/2实现，协议不匹配会导致Sidecar拦截转发请求时抛出协议错误，请求无法到达GRPC服务端。

修复步骤 #

• 修改GRPC服务对应的Kubernetes Service配置，为GRPC端口添加协议声明，两种配置方式二选一：
  1. 直接在port的name字段按协议-自定义后缀格式声明：

  apiVersion: v1
  kind: Service
  metadata:
    name: discount-grpc-service
  spec:
    ports:
    - port: 8080
      name: grpc-discount # 前缀固定为grpc，不区分大小写
      targetPort: 8080
  

  2. 显式指定appProtocol字段：

  apiVersion: v1
  kind: Service
  metadata:
    name: discount-grpc-service
  spec:
    ports:
    - port: 8080
      appProtocol: grpc # 直接声明协议为grpc
      targetPort: 8080
  

• 更新Service配置后，重启GRPC服务和调用方服务的Pod，确保Istio Sidecar加载最新的协议规则
• 验证GRPC调用是否恢复正常

补充排查点 #

如果修改后仍有问题，可按以下方向排查：

• 检查命名空间下是否存在冲突的VirtualService、DestinationRule配置，错误的路由规则会导致GRPC请求转发异常
• 确认Istio版本是否支持GRPC的相关特性，低版本Istio可能存在HTTP/2转发的已知Bug，可升级到1.10以上稳定版本测试
• 调用方GRPC客户端不要配置强制HTTP/2明文降级相关的特殊配置，保持默认配置即可适配Istio的Sidecar转发逻辑

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