新闻中心

如何在Golang中使用gRPC网关转换REST请求

2025-11-01
浏览次数:
返回列表
答案:在Golang中通过gRPC网关将REST转为gRPC调用需定义带google.api.http注解的proto文件,生成gRPC和服务代码后分别启动gRPC服务器和HTTP网关,实现RESTful API到内部gRPC的自动转换。

如何在golang中使用grpc网关转换rest请求

在Golang中使用gRPC网关将REST请求转换为gRPC调用,是构建现代微服务API的常见做法。它允许你通过HTTP/JSON对外提供RESTful接口,同时内部使用高性能的gRPC进行服务间通信。整个流程依赖于Protocol Buffers定义服务,并借助grpc-gateway生成反向代理代码。

定义Protocol Buffer服务

要启用gRPC网关,首先需要在.proto文件中定义gRPC服务,并添加特定的google.api.http注解来映射REST路径。

安装必要的proto插件:

go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

编写service.proto文件:

syntax = "proto3";

package example;

import "google/api/annotations.proto";

message HelloRequest {
  string name = 1;
}

message HelloResponse {
  string message = 1;
}

service Greeter {
  rpc SayHello (HelloRequest) returns (HelloResponse) {
    option (google.api.http) = {
      get: "/v1/hello/{name}"
    };
  }
}

这里option (google.api.http)SayHello方法绑定到GET /v1/hello/{name},URL中的{name}会自动映射到请求字段。

生成gRPC和gRPC-Gateway代码

运行protoc命令生成Go代码:

protoc \
  --go_out=. --go_opt=paths=source_relative \
  --go-grpc_out=. --go-grpc_opt=paths=source_relative \
  --grpc-gateway_out=. --grpc-gateway_opt=paths=source_relative \
  service.proto

这会生成三个文件:

  • service.pb.go:基础结构体和gRPC客户端/服务接口
  • service_grpc.pb.go:gRPC服务实现桩代码
  • service.pb.gw.go:gRPC网关的HTTP处理器,负责将REST转为gRPC调用

启动gRPC服务与HTTP网关

你需要同时运行gRPC服务器和HTTP网关。通常gRPC监听本地端口,而HTTP网关作为前端代理转发请求。

实现gRPC服务:

NameGPT NameGPT

免费的名称生成器,AI驱动在线生成企业名称及Logo

NameGPT 119 查看详情 NameGPT type server struct{}

func (s *server) SayHello(ctx context.Context, req *example.HelloRequest) (*example.HelloResponse, error) {
  return &example.HelloResponse{Message: "Hello " + req.Name}, nil
}

启动gRPC服务器:

lis, _ := net.Listen("tcp", ":50051")
s := grpc.NewServer()
example.RegisterGreeterServer(s, &server{})
s.Serve(lis)

启动HTTP网关(反向代理):

ctx := context.Background()
mux := runtime.NewServeMux()
opts := []grpc.DialOption{grpc.WithInsecure()}
_ = example.RegisterGreeterHandlerFromEndpoint(ctx, mux, "localhost:50051", opts)

http.ListenAndServe(":8080", mux)

现在你可以通过GET /v1/hello/world访问服务,网关会将其转换为gRPC调用并返回JSON响应。

处理复杂路由和方法

除了GET,你还可以映射POST、PUT等方法,并指定body字段:

rpc CreateBook(CreateBookRequest) returns (CreateBookResponse) {
  option (google.api.http) = {
    post: "/v1/shelves/{shelf_id}/books"
    body: "book"
  };
}

这表示POST数据到/v1/shelves/123/books,请求体中的JSON会被解析到book字段。

确保你的proto文件导入google/api/annotations.protogoogle/api/http.proto,可通过buf或手动下载管理依赖。

基本上就这些。只要定义好proto注解,生成代码并正确启动两个服务,gRPC网关就能自动完成REST到gRPC的转换,无需手动写HTTP handler。这种方式统一了API契约,便于维护和文档生成。不复杂但容易忽略的是注解语法和生成命令的参数顺序。

以上就是如何在Golang中使用gRPC网关转换REST请求的详细内容,更多请关注其它相关文章!


# 的是  # 滁州酒店网站建设  # 轴承推广网站排名  # 浙江企业seo优化  # 茂名优化网站推广  # 太仓网站建设极速建站  # 无棣网站建设  # 南京百度网站优化招聘  # 湖南营销型网站建设知识  # 烟台SEO整站优化价格  # 新闻营销是怎么推广的呢  # 相关文章  # 将其  # 你还  # 就能  # 你可以  # js  # 资源管理  # 转换为  # 如何在  # 加载  # restful api  # google  # 路由  # 端口  # 处理器  # golang  # github  # go  # json  # git  # 前端 


相关栏目: 【 科技资讯46185 】 【 网络学院92790


相关推荐: 12306选座如何查看座位示意图_12306座位示意图解读与使用  天猫双十一预售商品怎么退款_天猫双十一预售退款操作指南  Word2013如何插入视频和音频媒体_Word2013媒体插入的多媒体支持  使用 Pandas 高效处理 .dat 文件:字符清理与数据计算  HTML转PPT成品工具有哪些?HTML网页转PPT成品工具大全  腾讯QQ邮箱登录入口_QQ邮箱官方网站使用地址  如何提高微信支付的安全性_微信支付安全防护与设置建议  HTML元素状态管理:根据DIV内容动态启用/禁用按钮  TikTok评论显示延迟如何处理 TikTok评论刷新优化方法  QQ邮箱官方网页版登录 QQ邮箱个人邮箱快速访问  Python getattr() 异常处理深度解析:避免程序意外退出  在Go Martini框架中高效服务动态生成图像的实践指南  React Hooks最佳实践:动态组件状态管理的组件化方案  Steam官网入口直达 Steam注册及登录步骤  AO3最新可访问网址 Archive of Our Own官方在线入口  CSS Box Model与弹性按钮:维持布局稳定的动画实践  快手极速版在线观看 官方网页版登录地址  消息称三星明年 2 月正式发布 HBM4,与 SK 海力士同台竞技  uc浏览器网页版入口 uc浏览器网页版最新网址  机构:以往存储涨价周期小米利润率实际上有所改善 能转嫁给消费者等  Win10如何清理注册表垃圾 Win10手动清理无效注册表【技巧】  飞书妙记怎样用语音转文字速记_飞书妙记用语音转文字速记【速记方法】  c++中的const_cast和reinterpret_cast怎么用_c++四种类型转换  PHP中获取MongoDB服务器运行时间(Uptime)的专业指南  整合Supabase认证与Django模型:跨模式迁移的解决方案  在J*a中如何在J*a中使用异常机制记录错误日志_异常日志实践经验  sublime怎么预览Markdown渲染效果_Markdown Preview插件 for sublime教程  J*a应用集成GitHub CLI与API认证指南  抖音网页版企业服务中心登录入口_抖音网页版企业登录平台  C++如何操作注册表_Windows平台下C++读写注册表的API函数详解  jQuery Mask 插件中实现电话号码固定前导零的教程  格力空气能E5故障代码是什么情况_格力空气能E5代码解析与应对措施  html怎么运行外部js文件中的函数_运html外js文件函数法【技巧】  三星ZFold5多任务卡顿_Samsung ZFold5流畅度提升  Python实时数据流中的动态最值查找策略  php源码怎么看淘宝客系统_看php源码淘宝客系统技巧  lar*el怎么安全地存储和获取配置文件中的敏感信息_lar*el敏感信息安全存储方法  怎样在Excel中做仪表盘_Excel仪表盘设计与关键指标展示方法  百度浏览器字体显示异常偏小_百度浏览器字体渲染修复方案  J*aScript中高效管理与清空动态列表:避免循环陷阱  汽水音乐在线解析 汽水音乐在线解析入口  2025俄罗斯Yandex最新入口 官方网站地址及浏览器下载指南  怎么在html里运行vbs脚本_html中运行vbs脚本方法【教程】  照顾宝贝2小游戏免费秒玩入口  React项目中导航栏Logo自适应布局:避免裁剪与布局溢出  漫蛙官网正版漫画入口 漫蛙2官方网页登录地址  Go语言中的*string:深入理解字符串指针  Golang如何使用bytes.Split分割字节切片_Golang bytes切片分割方法  Mac终端命令大全_Mac常用Terminal指令速查  HuggingFaceEmbeddings中向量嵌入维度调整的限制与理解 

搜索