Go语言gRPC Gateway序列化问题：请求字段初始化为零值

核心问题：gRPC Gateway HTTP注解缺失body配置 #

你的proto文件中，PayIn方法的google.api.http注解仅指定了POST路径，未配置body字段。gRPC Gateway无法识别如何将HTTP请求体绑定到gRPC请求消息，导致所有字段被初始化为零值。

修改proto中的服务方法配置：

rpc PayIn(PayInRequest) returns(PayInResponse) {
    option(google.api.http) = {
        post: "/payment/pay_in"
        body: "*" // 将整个请求体映射到PayInRequest
    };
}

body: "*"表示把HTTP请求的完整JSON body映射到gRPC的PayInRequest消息。若只需映射部分字段，可指定具体字段名，此处需完整映射故用*。

其他需检查的点 #

• 请求Content-Type必须为application/json：发送请求时需设置正确的Content-Type头，否则gRPC Gateway无法解析JSON请求体。
• 重新生成代码：修改proto后必须重新运行代码生成命令，确保配置更新生效。示例命令：

  # 生成gRPC Go代码
  protoc --go_out=. --go_opt=paths=source_relative \
    --go-grpc_out=. --go-grpc_opt=paths=source_relative \
    # 生成gRPC Gateway代码
    --grpc-gateway_out=. --grpc-gateway_opt=paths=source_relative \
    payment.proto
  

• 字段名映射验证：检查生成的paymentProto/payment.pb.go文件中PayInRequest的结构体字段标签，确保json标签与请求字段名一致，比如：

  type PayInRequest struct {
      state         protoimpl.MessageState
      sizeCache     protoimpl.SizeCache
      unknownFields protoimpl.UnknownFields
  
      UserID                  uint64  `protobuf:"varint,1,opt,name=userID,proto3" json:"userID,omitempty"`
      // 其他字段...
  }
  

验证修改 #

修改proto并重新生成代码后，重启gRPC和HTTP服务器，再次发送请求即可正确解析所有字段值。

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