GRPC双向流经Ingress Nginx Controller无法实时传输消息求助

问题核心 #

当使用Nginx Ingress Controller转发gRPC双向流时，未调用客户端onComplete()时消息无法送达服务端，且会触发client_body_timeout导致408超时错误，本质是Nginx的HTTP配置与gRPC流模型不兼容。

解决方案 #

1. 清理冲突的HTTP配置，使用gRPC专属参数 #

移除client_body_timeout这类HTTP请求体相关的配置，因为gRPC双向流基于HTTP/2的流式传输，不需要等待请求体完成。调整后的Ingress注解配置如下：

nginx.ingress.kubernetes.io/backend-protocol: GRPC
nginx.ingress.kubernetes.io/client-body-buffer-size: 4M
nginx.ingress.kubernetes.io/configuration-snippet: |
  grpc_send_timeout 3600s;
  grpc_read_timeout 3600s;
  proxy_ignore_client_abort on;
  grpc_next_upstream_tries 3;
nginx.ingress.kubernetes.io/proxy-body-size: 0m
nginx.ingress.kubernetes.io/proxy-buffering: "off"
nginx.ingress.kubernetes.io/proxy-request-buffering: "off"

• grpc_send_timeout/grpc_read_timeout：设置gRPC流的读写超时，根据业务场景调整为足够长的时间（比如3600s）
• 移除client_body_timeout/proxy-read-timeout/proxy-send-timeout：这些是HTTP1.1的超时参数，与gRPC HTTP/2流冲突

2. 确保Nginx Ingress版本支持gRPC双向流 #

确认使用的Ingress Nginx Controller版本不低于0.29.0，该版本开始完善对gRPC双向流的支持。如果版本过低，建议升级到稳定版（比如v1.x系列）。

3. 客户端保持流活跃 #

如果业务场景下长时间没有消息传输，Nginx可能会因为超时断开连接。可以在客户端定期发送心跳消息，保持流的活跃：

// 添加心跳逻辑，每隔30秒发送一次心跳
ScheduledExecutorService scheduler = Executors.newSingleThreadScheduledExecutor();
scheduler.scheduleAtFixedRate(() -> {
    if (streamObserver != null) {
        HealthRequest heartbeat = HealthRequest.newBuilder().setName("HEARTBEAT").build();
        streamObserver.onNext(heartbeat);
    }
}, 30, 30, TimeUnit.SECONDS);

4. 验证Nginx配置生效 #

应用Ingress配置后，通过kubectl exec进入Ingress Pod查看/etc/nginx/nginx.conf，确认gRPC相关配置已正确加载，且没有残留的HTTP请求体超时配置。

问题原因分析 #

• 之前配置的client_body_timeout是针对HTTP1.1的请求体接收超时，而gRPC双向流是通过HTTP/2的单个流持续传输消息，Nginx会误认为请求体未完成，超时后返回408错误，导致流被关闭。
• 即使设置了proxy-request-buffering: "off"，client_body_timeout的存在依然会触发Nginx对请求体完成性的检查，与gRPC的流式模型冲突。

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