.NET 6 gRPC流式大文件上传报错：请求流中止（K8s环境）

核心排查方向及解决方案 #

1. Ingress Controller的HTTP/2配置问题 #

gRPC依赖HTTP/2协议，K8s环境中常用的NGINX Ingress默认可能存在配置缺失：

• 检查Ingress资源的annotations，补充HTTP/2相关配置：

  annotations:
    nginx.ingress.kubernetes.io/http2-push-preload: "true"
    nginx.ingress.kubernetes.io/ssl-alpn-protocols: "h2,http/1.1"
    nginx.ingress.kubernetes.io/proxy-buffering: "off" # 关闭代理缓冲，避免流式请求被截断
  

• 确保Ingress配置了有效的SSL证书，HTTP/2通常需要TLS支持，未加密的请求可能被强制降级到HTTP/1.1，导致gRPC连接异常。

2. Pod资源限制与gRPC参数配置 #

• 查看Pod状态，检查是否存在OOMKilled或CPU throttled事件：

  kubectl describe pod <your-grpc-pod-name>
  

• 调整Pod的resources配额，增加CPU和内存的requests/limits值，避免大文件处理时资源耗尽。
• 修改服务端gRPC配置，放宽消息大小限制并启用详细错误：

  builder.Services.AddGrpc(options =>
  {
      options.MaxReceiveMessageSize = int.MaxValue;
      options.MaxSendMessageSize = int.MaxValue;
      options.EnableDetailedErrors = true;
  });
  

3. 集群网络策略与连接保活配置 #

• 检查NetworkPolicy规则，确保客户端所在网络能访问gRPC服务的Pod端口。
• 配置Pod的TCP keepalive参数，防止长连接被K8s网络组件中断：

  securityContext:
    sysctls:
    - name: net.ipv4.tcp_keepalive_time
      value: "60"
    - name: net.ipv4.tcp_keepalive_intvl
      value: "10"
    - name: net.ipv4.tcp_keepalive_probes
      value: "3"
  

4. 客户端分片大小适配MTU限制 #

K8s集群默认MTU通常为1500，过大的分片可能导致数据包丢失：

• 调整客户端上传分片大小，建议设置为512KB以内：

  const int chunkSize = 512 * 1024; // 512KB
  using var fileStream = new FileStream(filePath, FileMode.Open, FileAccess.Read);
  byte[] buffer = new byte[chunkSize];
  int bytesRead;
  while ((bytesRead = await fileStream.ReadAsync(buffer, 0, buffer.Length)) > 0)
  {
      await uploadStream.RequestStream.WriteAsync(new UploadFileRequest
      {
          Chunk = ByteString.CopyFrom(buffer, 0, bytesRead)
      });
  }
  

5. 启用详细日志排查 #

• 客户端启用gRPC debug日志，获取更细粒度的连接中断信息：

  var channel = GrpcChannel.ForAddress("https://your-grpc-service", new GrpcChannelOptions
  {
      LoggerFactory = LoggerFactory.Create(builder =>
      {
          builder.AddConsole().SetMinimumLevel(LogLevel.Debug);
      })
  });
  

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