Cloudflare+Nginx+Fabio配置gRPC遇502错误排查求助

错误原因定位 #

从Nginx错误日志的upstream sent too large http2 frame: 4740180可直接确定问题：后端（Fabio转发的gRPC服务）返回的HTTP2帧大小（约4.5MB）超过了Nginx的默认限制，导致Nginx拒绝处理请求，返回502错误。

解决步骤 #

1. 调整Nginx HTTP2帧大小限制

在Nginx的server配置块中添加HTTP2相关的大小限制参数，覆盖默认值：

server {
    listen [::]:443 ssl http2 ipv6only=on;
    listen 443 ssl http2;

    server_name grpc.example.com;

    # 添加HTTP2帧大小限制，按需调整数值
    http2_max_frame_size 16m;
    http2_max_header_size 16m;

    location /{
        grpc_pass grpc://127.0.0.1:9999;
    }

    ssl_certificate /etc/letsencrypt/live/grpc.example.com/fullchain.pem; 
    ssl_certificate_key /etc/letsencrypt/live/grpc.example.com/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;
}

修改后重启Nginx生效：systemctl restart nginx

2. 验证Fabio与后端gRPC服务的连通性

• 直接在服务器上用gRPC客户端测试访问localhost:9999，确认Fabio能正常转发请求到后端gRPC实例，排除Fabio自身的配置或转发故障
• 检查Docker容器中的gRPC应用是否正常运行，日志无报错

3. Cloudflare侧确认配置

• 确保子域名的gRPC功能已开启，SSL模式设置为Full或Full (strict)，避免SSL层握手异常
• Cloudflare默认HTTP2帧大小限制为16MB，和我们设置的Nginx值匹配，无需额外调整

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