部署Istio规则后GRPC Client无法找到匹配的虚拟主机

核心错误分析 #

错误UNAVAILABLE: Failed to find virtual host matching hostname: grpc-server-service.grpc-istio.svc.cluster.local:9090表明Envoy Sidecar无法匹配对应虚拟主机，核心原因是请求的:authority头（HTTP/2协议字段，对应HTTP/1.1的Host头）包含端口号，但你的VirtualService配置的hosts仅为不带端口的服务FQDN，导致路由匹配失败。

具体排查与修复步骤 #

1. 适配GRPC协议修正VirtualService配置 #

GRPC基于HTTP/2协议，Istio推荐针对GRPC服务使用grpc路由段而非http，同时确保hosts仅包含服务FQDN（不带端口），并补充默认路由避免无匹配头时请求失败：

apiVersion: networking.istio.io/v1alpha3
kind: VirtualService
metadata:
  name: grpc-server-route
  namespace: grpc-istio
spec:
  hosts:
    - grpc-server-service.grpc-istio.svc.cluster.local
  grpc:
  - match:
    - metadata:
        SERVER:
          exact: "server-1"
    route:
    - destination:
        host: grpc-server-service.grpc-istio.svc.cluster.local
        subset: server-1
  - match:
    - metadata:
        SERVER:
          exact: "server-2"
    route:
    - destination:
        host: grpc-server-service.grpc-istio.svc.cluster.local
        subset: server-2
  # 添加默认路由，处理无SERVER头的请求
  - route:
    - destination:
        host: grpc-server-service.grpc-istio.svc.cluster.local

2. 确保GRPC调用传递正确元数据 #

客户端接收HTTP请求后发起GRPC调用时，需将HTTP请求中的SERVER参数转换为GRPC元数据（对应HTTP/2头信息）传递。Java代码示例：

// 在GrpcClientHandler.getServerSubset方法中添加元数据处理
Metadata metadata = new Metadata();
metadata.put(Metadata.Key.of("SERVER", Metadata.ASCII_STRING_MARSHALLER), serverSubsetParam);
// 携带元数据发起GRPC调用
grpcStub.withInterceptors(MetadataUtils.newAttachHeadersInterceptor(metadata)).getServerSubset(request);

3. 修正客户端xDS地址配置 #

客户端环境变量中的xDS URI无需携带端口（端口由Kubernetes Service的映射规则处理），修改后可避免:authority头包含端口：

env:
  - name: GRPC_SERVER_ADDRESS
    value: "xds:///grpc-server-service.grpc-istio.svc.cluster.local"

4. 验证Service配置有效性 #

确认已创建对应Service，选择器匹配服务端Pod的app: grpc-server标签，端口映射正确：

apiVersion: v1
kind: Service
metadata:
  name: grpc-server-service
  namespace: grpc-istio
spec:
  selector:
    app: grpc-server
  ports:
    - name: grpc
      port: 9090
      targetPort: 9090

5. 检查Sidecar配置同步状态 #

执行以下命令确认Sidecar已正确注入并同步Istio配置：

# 查看客户端Pod的Sidecar配置
kubectl exec -n grpc-istio <grpc-client-pod-name> -c istio-proxy -- curl localhost:15000/config_dump
# 验证是否包含目标服务的路由配置
kubectl exec -n grpc-istio <grpc-client-pod-name> -c istio-proxy -- curl localhost:15000/config_dump | grep "grpc-server-service.grpc-istio.svc.cluster.local"

修复验证 #

部署修正后的配置后，测试以下场景：

• 携带SERVER=server-1头的HTTP请求应路由到server: server-1标签的服务端Pod
• 携带SERVER=server-2头的HTTP请求应路由到server: server-2标签的服务端Pod
• 无SERVER头的请求会通过默认路由分发到任意服务端Pod

内容的提问来源于stack exchange，提问作者aditya ranjan Barik