使用gRPC-Gateway生成proto时为何未生成Register*FromEndpoint HTTP注册方法

你当前执行的protoc命令仅调用了protoc-gen-go和protoc-gen-go-grpc两个插件，分别生成普通protobuf消息代码、gRPC协议层的服务端/客户端代码（即health_grpc.pb.go）。你要找的Register*FromEndpoint方法属于grpc-gateway的HTTP适配代码，由独立的protoc-gen-grpc-gateway插件生成，不会出现在原有gRPC生成文件中。

安装grpc-gateway生成插件 #

执行以下命令安装所需插件，确保插件存放路径加入系统PATH环境变量（即Go环境变量GOPATH/bin）：

go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest

如需生成配套OpenAPI接口文档，可额外安装可选插件：

go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2@latest

调整protoc生成命令 #

在原有命令基础上新增grpc-gateway生成参数：

protoc --go_out=api/proto/ --go_opt=paths=source_relative \
    --go-grpc_out=./api/proto --go-grpc_opt=paths=source_relative \
    --grpc-gateway_out=./api/proto --grpc-gateway_opt=paths=source_relative \
    --proto_path=internal/api \
    --proto_path=third_party \
    ./internal/api/health/health.proto

验证结果 #

重新执行命令后，会在./api/proto目录下新增health.pb.gw.go文件，RegisterHealthHandlerFromEndpoint方法就定义在该文件中。

• 若执行新命令时报找不到google/api/annotations.proto的错误，检查third_party目录下是否已存放grpc-gateway依赖的公共proto文件（如google/api/http.proto、google/api/annotations.proto）。
• 若protoc提示找不到protoc-gen-grpc-gateway，检查GOPATH/bin是否已加入系统PATH环境变量。
• 若使用grpc-gateway v1版本，插件安装路径及生成参数需对应调整，推荐优先使用官方维护的v2版本。

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