如何配置Python gRPC服务器在不安全通道使用HTTP/2协议？

你使用proto3和Python搭建的基础gRPC客户端-服务器通信服务，通过add_insecure_port开启不安全端口后，客户端通信正常，但Wireshark捕获到的流量显示使用HTTP/1.1协议——而gRPC本应默认基于HTTP/2运行。以下是解决方法：

核心说明 #

gRPC在不安全通道下对应的是明文HTTP/2（h2c），你遇到的HTTP/1.1情况，通常是客户端未正确发起h2c请求，或gRPC版本/配置存在问题。

解决步骤 #

1. 升级gRPC依赖
   旧版本的Python gRPC包在不安全通道的HTTP/2支持上可能存在缺陷，先执行升级：

   pip install --upgrade grpcio grpcio-tools
   

2. 服务器端强制HTTP/2配置
   创建gRPC服务器时，添加HTTP/2专属配置项，禁用HTTP/1.1：

   import grpc
   from concurrent import futures
   from my_proto import my_service_pb2_grpc
   
   def serve():
       # 配置强制启用HTTP/2的选项
       http2_options = [
           ('grpc.http2.enable', True),
           ('grpc.http2.proxy_behavior', 'HTTP2'),
           ('grpc.http2.max_pings_without_data', 0)
       ]
       server = grpc.server(
           futures.ThreadPoolExecutor(max_workers=10),
           options=http2_options
       )
       my_service_pb2_grpc.add_MyServiceServicer_to_server(MyService(), server)
       server.add_insecure_port('[::]:50051')
       server.start()
       server.wait_for_termination()
   
   if __name__ == '__main__':
       serve()
   

3. 确保客户端使用gRPC标准客户端
   客户端必须使用gRPC专属客户端连接，而非普通HTTP客户端，否则会触发HTTP/1.1请求：

   import grpc
   from my_proto import my_service_pb2, my_service_pb2_grpc
   
   def run():
       with grpc.insecure_channel('localhost:50051') as channel:
           stub = my_service_pb2_grpc.MyServiceStub(channel)
           response = stub.MyMethod(my_service_pb2.MyRequest())
           print("响应结果:", response.message)
   
   if __name__ == '__main__':
       run()
   

4. Wireshark流量验证
   在Wireshark中使用过滤规则http2查看流量，确认是否出现HTTP/2帧。若仍显示HTTP/1.1，可检查客户端是否发送了Upgrade: h2c请求头——gRPC客户端默认会自动发送该头。

代码翻译 #

你提到的代码片段：

server.add_secure_port(f"{ip}:{port}",credentials)

翻译为：

server.add_secure_port(f"{IP地址}:{端口号}", 证书凭据)

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