GRPC Web+Nginx反向代理下服务端流响应延迟及编码错误求助

问题背景 #

在Amazon Linux 2 EC2实例上部署Go gRPC服务，通过gRPC Web封装供Next.js应用调用，Nginx反向代理分别处理常规gRPC（端口8000）和gRPC Web（端口443）请求。服务端流式功能在常规gRPC下正常，但gRPC Web请求存在以下问题：

• 客户端请求后状态一直处于pending，直到流关闭才收到所有响应，中间实时响应无法推送
• 偶尔出现(failed)net::ERR_INCOMPLETE_CHUNKED_ENCODING错误

核心原因 #

Nginx默认会缓冲后端响应，直到响应完整后才转发给客户端，这与gRPC Web流式响应的实时推送需求冲突。此外，缺少针对gRPC Web流式场景的特定代理配置，导致Chunked编码处理异常。

解决方案 #

修改gRPC Web对应的Nginx配置，添加流式响应所需的关键设置：

1. 禁用响应缓冲 #

在gRPC Web的location /块中添加proxy_buffering off;，强制Nginx实时转发后端的流式响应。

2. 调整连接与编码头 #

添加proxy_set_header Connection "";（避免HTTP/1.1的Keep-Alive干扰），确保Chunked编码能正常传递到客户端。

3. 保留适配流式的超时设置 #

保持原有超时配置的同时，确保禁用缓冲后超时逻辑适配长连接流式场景。

修改后的Nginx配置（gRPC Web部分） #

server {
    server_name example.org;

    location / {
        proxy_http_version 1.1;
        proxy_pass http://127.0.0.1:5001;
        # 禁用缓冲，实时转发流式响应
        proxy_buffering off;
        # 清除Connection头，避免Keep-Alive干扰
        proxy_set_header Connection "";
        # 超时设置保持原有配置
        proxy_read_timeout 300;
        proxy_connect_timeout 300;
        proxy_send_timeout 300;
    }

    access_log /var/log/nginx/example.org/access.log;
    error_log /var/log/nginx/example.org/error.log;

    listen [::]:443 ssl; # managed by Certbot
    listen 443 ssl; # managed by Certbot
    ssl_certificate /etc/letsencrypt/live/example.org/fullchain.pem; # managed by Certbot
    ssl_certificate_key /etc/letsencrypt/live/example.org/privkey.pem; # managed by Certbot
    include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot
}

验证步骤 #

1. 重启Nginx服务：sudo systemctl restart nginx
2. 测试Next.js客户端的流式请求，确认是否能实时接收服务端推送的中间响应
3. 查看Nginx错误日志（/var/log/nginx/example.org/error.log），确认是否还有ERR_INCOMPLETE_CHUNKED_ENCODING相关报错

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