Nginx配置grpc_pass仅根路径生效非根路径无响应问题咨询

• gRPC 协议的请求路径是基于 Protobuf 定义的服务、方法自动生成的，固定为 /<包名>.<服务名>/<方法名> 的格式，默认不会携带额外的自定义路径前缀。你将 location 配置为 /test 后，客户端发起的原始 gRPC 请求路径（如日志中的 /tasks.TasksServiceGRPC/AskForJob）无法匹配该规则，因此 Nginx 不会将请求转发到上游 gRPC 服务，也不会生成对应请求日志。
• 同场景下 HTTP 1.1 配置可正常运行，是因为 HTTP 接口的路径支持自定义前缀，客户端可以主动适配路径规则，但 gRPC 路径是协议层自动生成的，无法随意修改前缀，因此同样的配置逻辑不适用于 gRPC 场景。

根据你的使用场景，可以选择以下任意一种方案解决：

方案1：路径重写适配前缀规则 #

如果需要用 /test 前缀区分不同的上游服务，可以新增路径重写规则，把请求前缀去掉后再转发到上游，配置示例如下：

server {
    listen 5005 http2;
    
    location ^~ /test {
        # 去掉请求路径中的/test前缀，将剩余原生gRPC路径传给上游
        rewrite ^/test(.*)$ $1 break;
        grpc_pass grpc://my_app:5001;
    }

    default_type application/grpc;
}

使用该方案时，客户端发起请求需要在原生 gRPC 路径前增加 /test 前缀，比如原本调用地址为 localhost:5005/tasks.TasksServiceGRPC/AskForJob，修改为 localhost:5005/test/tasks.TasksServiceGRPC/AskForJob 即可。

方案2：按gRPC原生路径匹配 #

如果不需要自定义前缀区分服务，直接按 gRPC 原生路径规则配置 location 即可，不需要修改客户端调用逻辑，配置示例如下：

server {
    listen 5005 http2;
    
    # 匹配tasks.TasksServiceGRPC服务的所有请求
    location /tasks.TasksServiceGRPC {
        grpc_pass grpc://my_app:5001;
    }

    default_type application/grpc;
}

如果要代理该端口下所有gRPC服务，也可以直接还原为根路径匹配规则即可。

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