gRPC-Web生成React客户端存根缺失Upload方法问题求助

架构老林

2026-7-10

问题原因与解决思路

核心原因

你定义的Upload RPC是纯客户端流类型（rpc Upload(stream ChunkRequest) returns (ChunkResponse)），而当前protoc-gen-grpc-web（v1.4.2）不支持纯客户端流的RPC方法，因此生成的客户端存根不会包含该方法的实现，仅会生成基础的客户端构造函数。

grpc-web目前仅支持以下三种RPC类型：

单向RPC（Unary）：客户端发单个请求，服务器返回单个响应
服务器流RPC（Server Streaming）：客户端发单个请求，服务器返回多个响应流
双向流RPC（Bidirectional Streaming）：客户端和服务器互相发送流数据

纯客户端流（仅客户端发流，服务器返回单个响应）不在支持范围内。

解决方案

方案1：改为双向流RPC

修改proto文件中的RPC定义为双向流类型，这样grpc-web会生成对应的方法实现：

service UploadService {
    rpc Upload(stream ChunkRequest) returns (stream ChunkResponse);
}

之后重新执行你原来的生成命令：

protoc -I=. video_chunk.proto --js_out=import_style=commonjs:. --grpc-web_out=import_style=commonjs,mode=grpcwebtext:.

实际使用时，服务器可以在接收完所有文件块后，发送一个最终的ChunkResponse即可，客户端忽略中间可能的空响应（如果有的话）。

方案2：调整为非流式API

如果文件大小允许，可以改为普通的单向RPC，直接上传完整文件：

message UploadRequest {
    bytes content = 1;
    string filename = 2;
}

service UploadService {
    rpc Upload(UploadRequest) returns (ChunkResponse);
}

如果文件过大，可以拆分多个单向RPC请求，分块上传后再由服务器合并。