gRPC部署遇Unexpected HTTP/1请求错误求助

核心问题定位 #

你遇到的错误本质是反向代理（如Ingress/Nginx）未正确转发gRPC流量，导致HTTP/1.x请求被发送到仅支持HTTP/2的gRPC服务端；浏览器访问报错则是因为gRPC不兼容HTTP/1.x的浏览器请求格式。

分步解决 #

1. 验证服务端本身是否正常运行

grpc/java-example-hostname镜像已包含完整的gRPC服务端（无需单独部署客户端），默认监听50051端口并开启了反射服务。先在集群内部或能直接访问Pod的环境测试：

grpcurl -plaintext <你的PodIP>:50051 list

如果返回类似hostname.HostnameService的服务列表，说明服务本身无问题，问题出在外部访问的代理配置。

2. 修复反向代理的gRPC转发配置

你用443端口访问，说明存在反向代理将HTTPS流量转发到服务的50051端口。需要确保代理正确识别并转发gRPC的HTTP/2流量：

• 若使用Kubernetes Nginx Ingress，添加以下注解：

  nginx.ingress.kubernetes.io/backend-protocol: "GRPC"
  nginx.ingress.kubernetes.io/ssl-redirect: "true"
  

  同时Ingress路径配置需覆盖gRPC服务的所有路径（如/*）。
• 其他代理（如Traefik）需开启gRPC支持，并配置后端使用h2c（明文HTTP/2）协议转发。

3. 正确调用gRPC服务

代理配置完成后，用以下命令测试外部访问：

grpcurl testgrpc.{url}:443 list

此时代理会正确将HTTPS的gRPC请求转发到服务端，应该能正常返回服务列表。

4. 关于浏览器与Postman测试

• 浏览器无法直接访问gRPC服务：浏览器发送的是HTTP/1.x请求，而gRPC依赖HTTP/2的二进制帧协议，因此会返回乱码错误。
• Postman测试：该镜像已开启反射服务，直接在Postman的gRPC模块中输入服务地址testgrpc.{url}:443，即可通过反射加载服务定义并测试，无需手动导入proto文件。

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