快速上手Golang微服务：一个简单的HTTP转RPC示例-Golang-PHP中文网

直接用net/http转grpc不靠谱，因http与grpc在通信模型、序列化、错误语义上根本不同，硬桥接易丢状态、错码、超时失控；应使用grpc-gateway代码生成器，依据proto注解自动生成一致协议的http handler。

快速上手golang微服务：一个简单的http转rpc示例

为什么直接用 net/http 写 HTTP 接口再转 gRPC 不靠谱

因为 HTTP 和 gRPC 的通信模型、序列化方式、错误语义完全不同，硬桥接容易丢状态、错码、超时失控。比如 http.HandlerFunc 返回的 500 会被 gRPC 客户端当成 Unknown 错误，而 gRPC 的 DeadlineExceeded 在 HTTP 层根本没对应字段。

HTTP 请求头（如 Content-Type）和 gRPC 的 grpc-encoding、te: trailers 冲突，不手动透传会静默失败
gRPC 的流式响应无法映射到单次 HTTP 响应，强行模拟会导致连接提前关闭或数据截断
Protobuf 编解码必须严格匹配 service 定义，HTTP body 直接反序列化 proto.Message 时若字段名/类型不一致，UnmarshalJSON 会静默忽略而非报错

用 grpc-gateway 实现 HTTP 到 gRPC 的自动路由

它不是代理，而是代码生成器：根据 .proto 文件生成 Go HTTP handler，内部调用本地 gRPC server，天然保证协议一致性。

安装依赖：go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest

在 .proto 中加 google.api.http 注解，例如：

rpc GetUser(GetUserRequest) returns (GetUserResponse) {
  option (google.api.http) = {
    get: "/v1/users/{id}"
  };
}

生成 gateway 代码：protoc -I. -I$GOPATH/src -I$GOPATH/src/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis --grpc-gateway_out=logtostderr=true:. api.proto
启动时需同时注册 gRPC server 和 gateway handler，且 gateway 必须用 grpc.Dial 连本地 gRPC listener（不能用 localhost:port，要用 unix:///tmp/socket 或 tcp://127.0.0.1:9000）

如何让 HTTP 请求体正确映射到 gRPC message 字段

默认只支持 URL 路径参数和查询参数映射，JSON body 需显式声明 body: "*"，否则 gateway 会忽略 POST body。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

写法示例：

rpc CreateUser(CreateUserRequest) returns (CreateUserResponse) {
  option (google.api.http) = {
    post: "/v1/users"
    body: "*"
  };
}

body: "user_name" 表示只取 JSON 中 user_name 字段赋值给 message 的同名字段；body: "*" 表示整个 JSON object 映射到 message 根对象
字段名必须与 proto 中 json_name 一致（如 string user_name = 1 [json_name = "user_name"];），否则 gateway 解析时字段为空
如果 proto 使用 syntax = "proto3"，空 JSON 字段（"field": null）会被忽略，不是设为零值——这是常见空指针 panic 来源

调试时发现 gateway 返回 404 或 503 怎么办

404 多半是 proto 注解路径没生效或 gateway mux 没注册 handler；503 通常是 gateway 连不上后端 gRPC server，而不是业务逻辑出错。

检查生成的 xxx.pb.gw.go 文件里是否有对应路由注册，搜索 GET/POST 方法名确认
确保 gRPC server 已启动且监听地址与 gateway dial 地址完全一致（注意 127.0.0.1 vs localhost 的 DNS 解析差异）
开启 gateway 日志：runtime.WithErrorHandler(func(ctx context.Context, mux *runtime.ServeMux, marshaler runtime.Marshaler, w http.ResponseWriter, r *http.Request, err error) { log.Printf("gateway err: %v", err) })
用 curl -v http://localhost:8080/v1/users/123 看响应头，如果返回 grpc-status: 12，说明是 gRPC 层返回了 NotFound，不是 gateway 路由问题