.NET 8服务容器化后gRPC无法通信 HTTP/2握手失败排查求助

核心排查方向 #

RTSP服务正常说明端口映射、容器基础运行无问题，问题集中在gRPC依赖的HTTP/2配置环节，按以下步骤逐一验证：

1. 确认.NET服务端的HTTP/2配置 #

• 检查Program.cs是否显式为gRPC端口启用HTTP/2。.NET 8默认对gRPC启用HTTP/2，但Docker环境下需确保配置无遗漏：

  builder.WebHost.ConfigureKestrel(options =>
  {
      options.ListenAnyIP(5053, o => o.Protocols = HttpProtocols.Http2);
  });
  

• 排查HTTPS冲突：gRPC默认要求HTTPS（本地开发除外），若容器内服务未配置HTTPS证书，需要么服务端允许明文HTTP/2传输，要么客户端配置允许不安全连接。

2. 验证Docker网络与端口转发 #

• 尝试切换到host网络模式测试（仅适用于Windows Docker Desktop的WSL2后端），绕过NAT端口映射的协议限制：

  docker run --network host -it --rm myservice:1.0
  

  调用时直接使用localhost:5053，若恢复正常，说明是端口映射的HTTP/2转发问题。

3. 检查客户端调用配置 #

• .NET客户端需显式允许非HTTPS的gRPC连接（若服务端未配置HTTPS）：

  var channel = GrpcChannel.ForAddress("http://localhost:5053", new GrpcChannelOptions
  {
      EnablePlaintext = true
  });
  

• 用grpcurl工具直接测试服务可用性：

  grpcurl -plaintext localhost:5053 list
  

  若返回服务列表，说明服务端正常，问题出在客户端配置。

4. 检查容器内服务监听状态 #

• 进入容器内部，验证5053端口的监听协议：

  docker exec -it <容器ID> bash
  # 安装netstat（若未预装）
  apt-get update && apt-get install net-tools
  netstat -tulpn | grep 5053
  

  确认输出中协议为h2（HTTP/2），而非http/1.1。

5. 排查Docker镜像基础环境 #

• 确保Dockerfile使用官方运行时镜像mcr.microsoft.com/dotnet/aspnet:8.0，而非SDK镜像（SDK镜像可运行但aspnet镜像针对运行时优化，避免潜在兼容性问题）。
• 检查镜像中是否设置正确的环境变量：

  ENV ASPNETCORE_URLS=http://+:5053;http://+:8554
  

  确保gRPC端口的URL配置无错误。

6. 捕获并分析网络流量 #

• 在容器内用tcpdump抓包，分析HTTP/2握手细节：

  docker exec -it <容器ID> apt-get update && apt-get install tcpdump
  tcpdump -i any port 5053 -w grpc-traffic.pcap
  

  将pcap文件导出到本地，用Wireshark查看是否存在TLS握手失败（若用HTTPS）或HTTP/2设置帧未正常发送的情况。

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