使用Nginx替代Envoy时gRPC-Web JS客户端连接gRPC-Java后端失败求助

先给你一份适配gRPC-Web与gRPC-Java通信的Nginx配置示例，再拆解关键配置项和排查方向：

server {
    listen 8080 http2; # 必须启用HTTP/2，gRPC底层依赖HTTP/2协议

    # 跨域配置，根据你的实际前端域名替换*
    add_header Access-Control-Allow-Origin "*";
    add_header Access-Control-Allow-Methods "POST, OPTIONS";
    add_header Access-Control-Allow-Headers "Content-Type, grpc-timeout, X-Grpc-Web";

    # 处理浏览器OPTIONS预检请求
    if ($request_method = OPTIONS) {
        return 204;
    }

    # 匹配gRPC服务的路径（对应proto中定义的服务名）
    location /helloworld.Greeter/ {
        # 指向gRPC-Java服务的地址和端口
        grpc_pass grpc://localhost:9090;

        # 设置合理的超时时间，避免上游超时报错
        grpc_connect_timeout 10s;
        grpc_send_timeout 10s;
        grpc_read_timeout 10s;

        # 传递必要的请求头到后端服务
        grpc_set_header Host $host;
        grpc_set_header X-Real-IP $remote_addr;
        grpc_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

关键配置要点 #

• Nginx版本要求：必须是1.13.10及以上，这个版本开始原生支持gRPC代理
• HTTP/2启用：listen指令必须加http2，否则无法处理gRPC的HTTP/2流量
• 跨域处理：浏览器端gRPC-Web请求会触发OPTIONS预检，必须正确返回204并设置允许的头/方法
• 超时设置：默认的gRPC超时时间较短，根据服务实际处理能力调整grpc_connect_timeout等参数，解决上游超时问题
• 路径匹配：location要对应proto中定义的服务全名（比如helloworld.Greeter），确保请求能正确路由到对应的gRPC服务方法

针对你的问题的排查方向 #

1. 验证Java服务可用性：用grpcurl工具直接调用Java服务（grpcurl -plaintext localhost:9090 helloworld.Greeter/SayHello），确认服务本身能正常响应
2. 检查Nginx版本：执行nginx -v确认版本符合要求，旧版本不支持gRPC代理
3. 查看Nginx详细日志：开启Nginx的debug日志，检查上游连接是否正常、超时发生在哪个阶段
4. 后端NPE排查：Java服务的NPE大概率是因为请求体为空或解析失败，检查Nginx是否正确传递了Content-Type（application/grpc-web+proto或application/grpc-web-text），确保请求体完整转发到后端
5. 浏览器控制台报错：查看浏览器的Network面板，确认请求是否发送成功、是否有跨域错误或gRPC状态码异常

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