Golang在微服务中使用gRPC通信方法

Golang微服务通过gRPC实现高效通信,核心是使用Protocol Buffers定义服务契约,生成客户端和服务端代码,结合HTTP/2和二进制序列化提升性能,利用context进行超时、取消和元数据传递,相比REST具有强类型、高性能、多语言支持和流式传输优势,适合内部服务间高频调用,提升开发效率与系统稳定性。

golang在微服务中使用grpc通信方法

Golang在微服务中使用gRPC通信,提供了一种高效、类型安全且协议无关的解决方案,它基于HTTP/2和Protocol Buffers,特别适合内部服务间的高性能调用,能显著提升开发效率和系统稳定性。

解决方案

在Golang微服务中实现gRPC通信,核心在于通过Protocol Buffers(简称ProtoBuf)定义服务接口和数据结构,然后利用

protoc

工具生成Go语言的客户端和服务端代码。接着,在服务端实现这些接口,而在客户端则通过生成的桩代码与服务端进行交互。

具体的流程是这样的:你得先写一个

.proto

文件,这里面会定义你的服务有哪些方法(RPC),每个方法接收什么参数,返回什么结果。参数和结果都是通过

message

结构来定义的。我个人觉得,这个

.proto

文件就像是服务间通信的“契约”,一旦定下来,双方都得遵守。它的强类型特性,在编译阶段就能帮我们发现很多潜在问题,比JSON那种运行时才报错的体验好太多了。

有了

.proto

文件后,使用

protoc

编译器,配合

protoc-gen-go

protoc-gen-go-grpc

插件,就能自动生成Go语言的接口定义、消息结构体以及客户端和服务端的桩代码。这部分是真正解放双手的地方,省去了大量手写序列化/反序列化和网络通信代码的麻烦。

立即学习“go语言免费学习笔记(深入)”;

接下来,服务端需要创建一个gRPC服务器实例,实现

protoc

生成的服务接口。这通常意味着你要定义一个结构体,然后为它实现接口中的每一个RPC方法。这些方法里会包含你的业务逻辑。实现完之后,将这个服务注册到gRPC服务器上,然后让服务器监听一个端口并启动。

客户端的实现相对简单一些。它需要先建立一个与服务端gRPC服务器的连接,这通常是通过

grpc.Dial

函数完成的。连接成功后,就可以使用生成的客户端桩代码来调用服务端暴露的RPC方法了。调用时,需要传入相应的请求参数,并处理可能返回的响应或错误。

整个过程中,HTTP/2的多路复用、头部压缩等特性为gRPC带来了显著的性能优势,而Protocol Buffers的二进制序列化也比JSON更紧凑、解析更快。此外,

context.Context

在gRPC中扮演着至关重要的角色,它用于传递请求的生命周期信息、超时控制、取消信号以及元数据等,在微服务链路追踪和错误传播方面尤其有用。

为什么Golang微服务偏爱gRPC而非RESTful API?

这问题问得很好,也是我当初在技术选型时反复思考的。为什么我们这些搞微服务的人,尤其是用Golang的,越来越倾向于gRPC,而不是那些看起来更“通用”的RESTful API呢?

首先,最直观的感受就是性能。gRPC基于HTTP/2协议,支持多路复用,这意味着你不需要为每个请求都建立一个新的TCP连接,多个请求可以在同一个连接上并行传输。同时,它的数据序列化是基于Protocol Buffers的二进制格式,比REST常用的JSON文本格式要紧凑得多,解析速度也更快。在我实际的项目中,尤其是一些内部服务之间高频、大数据量的通信,gRPC的性能优势是压倒性的。REST在这些场景下,光是JSON的序列化和反序列化开销,就可能成为瓶颈。

其次是类型安全与契约。gRPC使用Protocol Buffers来定义服务接口和消息结构,这是一种强类型定义。一旦

.proto

文件确定,客户端和服务端都必须严格遵守这个契约。这意味着在编译时就能发现很多潜在的类型不匹配错误,而不是等到运行时才暴露出来。想想看,用REST时,你可能需要手动维护API文档,或者依赖Swagger/OpenAPI,但这些都不能像ProtoBuf那样提供编译时的强类型检查。我个人觉得,这种提前发现问题的能力,在大型、复杂的微服务架构中,简直是开发者的福音,能大大减少调试时间。

再者,代码生成的便利性不容小觑。通过

protoc

工具,我们可以自动生成客户端和服务端的桩代码。这不仅减少了大量重复性的样板代码编写,也保证了通信协议的一致性。你只需要关注业务逻辑的实现,而不用去操心底层的网络通信细节。对于多语言环境,gRPC原生支持多种编程语言,这意味着一个

.proto

文件可以为不同语言的服务生成各自的客户端/服务端代码,跨语言协作变得异常顺畅。

最后,gRPC在流式传输方面也比REST更灵活。它支持四种类型的RPC:一元(Unary)、服务端流(Server Streaming)、客户端流(Client Streaming)和双向流(Bidirectional Streaming)。这让它能够轻松应对实时数据推送、大数据上传、实时双向通信等复杂场景,而REST通常只能模拟这些场景,效率和实现复杂度都会高很多。当然,REST在对外暴露API,特别是需要浏览器直接访问的场景下,依然有其不可替代的优势,但对于服务内部的高效通信,gRPC无疑是更优的选择。

如何在Golang中优雅地定义gRPC服务和消息?

优雅地定义gRPC服务和消息,关键在于你的

.proto

文件。它不仅是服务间的通信契约,更是团队协作的基石。一个好的

.proto

文件,应该清晰、简洁、易于理解和维护。

首先,每个

.proto

文件都应该以

syntax = "proto3";

开头,表明你使用的是Protocol Buffers的第三个版本。接着,你需要定义

package

,这有助于避免命名冲突,并为生成的Go代码提供一个命名空间。例如:

package greet;

为了让

protoc

生成Go代码时能有正确的包名和导入路径,通常会加上

option go_package = "example.com/project/proto/greet;greet";

。这里

example.com/project/proto/greet

是模块路径,

greet

是生成的Go包名。我通常会把

.proto

文件放在项目的

proto

目录下,这样结构会比较清晰。

消息(

message

)是数据结构的核心。它们用来定义RPC方法的请求和响应。每个字段都应该有一个类型(如

string

,

int32

,

bool

等)和一个唯一的字段编号(field number)。字段编号一旦确定,就不应该改变,因为它们用于序列化和反序列化,改变了会破坏兼容性。

syntax = "proto3";package greet;option go_package = "github.com/myproject/proto/greet;greet";// 定义一个问候请求消息message HelloRequest {  string name = 1; // 字段编号1}// 定义一个问候响应消息message HelloResponse {  string message = 1;}// 定义一个枚举类型,用于表示状态enum Status {  UNKNOWN = 0;  SUCCESS = 1;  FAILED = 2;}// 包含枚举和嵌套消息的复杂示例message UserProfile {  string user_id = 1;  string username = 2;  repeated string emails = 3; // repeated 表示这是一个列表  Status current_status = 4;  message Address { // 嵌套消息    string street = 1;    string city = 2;    string zip_code = 3;  }  Address home_address = 5;}

服务(

service

)则定义了RPC方法。每个RPC方法都指定了请求消息和响应消息。

// 定义一个问候服务service Greeter {  // 一元RPC:客户端发送一个请求,服务端返回一个响应  rpc SayHello (HelloRequest) returns (HelloResponse);  // 服务端流式RPC:客户端发送一个请求,服务端返回多个响应  rpc SayHelloStream (HelloRequest) returns (stream HelloResponse);}

在实践中,我发现以下几点能帮助你更好地定义ProtoBuf:

文件组织: 按照领域或功能将

.proto

文件分开,而不是所有东西都堆在一个文件里。例如,

user.proto

定义用户相关的消息和服务,

order.proto

定义订单相关的。命名规范: 消息和服务名使用驼峰命名法(

CamelCase

),字段名使用蛇形命名法(

snake_case

),这与Go语言的习惯也比较一致。注释: 为消息、字段、服务和RPC方法添加清晰的注释,这对于团队成员理解你的设计至关重要,也能在生成的Go代码中体现出来。版本控制: 如果需要对服务进行破坏性变更,考虑使用版本号(例如

v1/greet.proto

,

v2/greet.proto

),或者通过添加新字段而不是删除或修改现有字段来保持向后兼容性。

遵循这些规范,你的gRPC定义会更加健壮和易于维护。

Golang gRPC客户端与服务端的典型实现模式是怎样的?

理解了

.proto

文件的定义,接下来就是如何在Golang中真正地实现gRPC的客户端和服务端了。这部分是把“契约”变成“代码”的关键。

服务端实现模式:

定义服务结构体: 首先,你需要定义一个结构体,这个结构体将作为你的gRPC服务的具体实现。它通常会嵌入

protoc

生成的

UnimplementedYourServiceServer

,这样可以确保即使你没有实现所有RPC方法,编译器也不会报错,并且未来Proto文件更新时,新的方法也不会导致编译失败。

package mainimport (    "context"    "log"    "net"    pb "github.com/myproject/proto/greet" // 导入生成的proto包    "google.golang.org/grpc")// server 结构体,实现了 GreeterServer 接口type server struct {    pb.UnimplementedGreeterServer // 嵌入生成的 UnimplementedServer}// SayHello 实现 GreeterServer 接口的 SayHello 方法func (s *server) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloResponse, error) {    log.Printf("Received: %v", in.GetName())    // 这里是你的业务逻辑    return &pb.HelloResponse{Message: "Hello " + in.GetName()}, nil}// SayHelloStream 实现服务端流式RPCfunc (s *server) SayHelloStream(in *pb.HelloRequest, stream pb.Greeter_SayHelloStreamServer) error {    log.Printf("Received stream request from: %v", in.GetName())    for i := 0; i < 3; i++ {        resp := &pb.HelloResponse{Message: "Stream Hello " + in.GetName() + " #" + string(rune('A'+i))}        if err := stream.Send(resp); err != nil {            log.Printf("Failed to send stream response: %v", err)            return err        }    }    return nil}

创建并启动gRPC服务器:

main

函数或其他启动逻辑中,你需要创建一个

grpc.Server

实例,注册你的服务实现,然后让它监听一个网络端口。

func main() {    lis, err := net.Listen("tcp", ":50051")    if err != nil {        log.Fatalf("failed to listen: %v", err)    }    s := grpc.NewServer()    pb.RegisterGreeterServer(s, &server{}) // 注册你的服务实现    log.Printf("server listening at %v", lis.Addr())    if err := s.Serve(lis); err != nil {        log.Fatalf("failed to serve: %v", err)    }}

客户端实现模式:

建立连接: 客户端首先需要使用

grpc.Dial

函数与gRPC服务端建立一个连接。这里你可以配置连接选项,例如是否使用TLS、连接超时等。

package mainimport (    "context"    "io"    "log"    "time"    pb "github.com/myproject/proto/greet"    "google.golang.org/grpc"    "google.golang.org/grpc/credentials/insecure" // 用于非TLS连接)func main() {    // 建立与gRPC服务器的连接    conn, err := grpc.Dial("localhost:50051", grpc.WithTransportCredentials(insecure.NewCredentials()))    if err != nil {        log.Fatalf("did not connect: %v", err)    }    defer conn.Close() // 确保连接在使用完毕后关闭    c := pb.NewGreeterClient(conn) // 创建客户端桩    ctx, cancel := context.WithTimeout(context.Background(), time.Second)    defer cancel()

调用RPC方法: 通过生成的客户端桩,你可以直接调用服务端暴露的RPC方法。你需要传入一个

context.Context

对象(用于控制请求的生命周期、超时等)和请求消息。

    // 调用一元RPC    r, err := c.SayHello(ctx, &pb.HelloRequest{Name: "World"})    if err != nil {        log.Fatalf("could not greet: %v", err)    }    log.Printf("Greeting: %s", r.GetMessage())    // 调用服务端流式RPC    stream, err := c.SayHelloStream(ctx, &pb.HelloRequest{Name: "StreamUser"})    if err != nil {        log.Fatalf("could not call SayHelloStream: %v", err)    }    for {        resp, err := stream.Recv()        if err == io.EOF {            break // 流结束        }        if err != nil {            log.Fatalf("Error receiving stream: %v", err)        }        log.Printf("Stream Greeting: %s", resp.GetMessage())    }}

以上就是Golang在微服务中使用gRPC通信方法的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1404069.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月15日 20:11:11
下一篇 2025年12月15日 20:11:19

相关推荐

  • HTML、CSS 和 JavaScript 中的简单侧边栏菜单

    构建一个简单的侧边栏菜单是一个很好的主意,它可以为您的网站添加有价值的功能和令人惊叹的外观。 侧边栏菜单对于客户找到不同项目的方式很有用,而不会让他们觉得自己有太多选择,从而创造了简单性和秩序。 今天,我将分享一个简单的 HTML、CSS 和 JavaScript 源代码来创建一个简单的侧边栏菜单。…

    2025年12月24日
    200
  • 前端代码辅助工具:如何选择最可靠的AI工具?

    前端代码辅助工具:可靠性探讨 对于前端工程师来说,在HTML、CSS和JavaScript开发中借助AI工具是司空见惯的事情。然而,并非所有工具都能提供同等的可靠性。 个性化需求 关于哪个AI工具最可靠,这个问题没有一刀切的答案。每个人的使用习惯和项目需求各不相同。以下是一些影响选择的重要因素: 立…

    2025年12月24日
    000
  • 带有 HTML、CSS 和 JavaScript 工具提示的响应式侧边导航栏

    响应式侧边导航栏不仅有助于改善网站的导航,还可以解决整齐放置链接的问题,从而增强用户体验。通过使用工具提示,可以让用户了解每个链接的功能,包括设计紧凑的情况。 在本教程中,我将解释使用 html、css、javascript 创建带有工具提示的响应式侧栏导航的完整代码。 对于那些一直想要一个干净、简…

    2025年12月24日
    000
  • 布局 – CSS 挑战

    您可以在 github 仓库中找到这篇文章中的所有代码。 您可以在这里查看视觉效果: 固定导航 – 布局 – codesandbox两列 – 布局 – codesandbox三列 – 布局 – codesandbox圣杯 &#8…

    2025年12月24日
    000
  • 隐藏元素 – CSS 挑战

    您可以在 github 仓库中找到这篇文章中的所有代码。 您可以在此处查看隐藏元素的视觉效果 – codesandbox 隐藏元素 hiding elements hiding elements hiding elements hiding elements hiding element…

    2025年12月24日
    400
  • 居中 – CSS 挑战

    您可以在 github 仓库中找到这篇文章中的所有代码。 您可以在此处查看垂直中心 – codesandbox 和水平中心的视觉效果。 通过 css 居中 垂直居中 centering centering centering centering centering centering立即…

    2025年12月24日 好文分享
    300
  • 如何在 Laravel 框架中轻松集成微信支付和支付宝支付?

    如何用 laravel 框架集成微信支付和支付宝支付 问题:如何在 laravel 框架中集成微信支付和支付宝支付? 回答: 建议使用 easywechat 的 laravel 版,easywechat 是一个由腾讯工程师开发的高质量微信开放平台 sdk,已被广泛地应用于许多 laravel 项目中…

    2025年12月24日
    000
  • 如何在移动端实现子 div 在父 div 内任意滑动查看?

    如何在移动端中实现让子 div 在父 div 内任意滑动查看 在移动端开发中,有时我们需要让子 div 在父 div 内任意滑动查看。然而,使用滚动条无法实现负值移动,因此需要采用其他方法。 解决方案: 使用绝对布局(absolute)或相对布局(relative):将子 div 设置为绝对或相对定…

    2025年12月24日
    000
  • 移动端嵌套 DIV 中子 DIV 如何水平滑动?

    移动端嵌套 DIV 中子 DIV 滑动 在移动端开发中,遇到这样的问题:当子 DIV 的高度小于父 DIV 时,无法在父 DIV 中水平滚动子 DIV。 无限画布 要实现子 DIV 在父 DIV 中任意滑动,需要创建一个无限画布。使用滚动无法达到负值,因此需要使用其他方法。 相对定位 一种方法是将子…

    2025年12月24日
    000
  • 移动端项目中,如何消除rem字体大小计算带来的CSS扭曲?

    移动端项目中消除rem字体大小计算带来的css扭曲 在移动端项目中,使用rem计算根节点字体大小可以实现自适应布局。但是,此方法可能会导致页面打开时出现css扭曲,这是因为页面内容在根节点字体大小赋值后重新渲染造成的。 解决方案: 要避免这种情况,将计算根节点字体大小的js脚本移动到页面的最前面,即…

    2025年12月24日
    000
  • Nuxt 移动端项目中 rem 计算导致 CSS 变形,如何解决?

    Nuxt 移动端项目中解决 rem 计算导致 CSS 变形 在 Nuxt 移动端项目中使用 rem 计算根节点字体大小时,可能会遇到一个问题:页面内容在字体大小发生变化时会重绘,导致 CSS 变形。 解决方案: 可将计算根节点字体大小的 JS 代码块置于页面最前端的 标签内,确保在其他资源加载之前执…

    2025年12月24日
    200
  • Nuxt 移动端项目使用 rem 计算字体大小导致页面变形,如何解决?

    rem 计算导致移动端页面变形的解决方法 在 nuxt 移动端项目中使用 rem 计算根节点字体大小时,页面会发生内容重绘,导致页面打开时出现样式变形。如何避免这种现象? 解决方案: 移动根节点字体大小计算代码到页面顶部,即 head 中。 原理: flexível.js 也遇到了类似问题,它的解决…

    2025年12月24日
    000
  • 形状 – CSS 挑战

    您可以在 github 仓库中找到这篇文章中的所有代码。 您可以在此处查看 codesandbox 的视觉效果。 通过css绘制各种形状 如何在 css 中绘制正方形、梯形、三角形、异形三角形、扇形、圆形、半圆、固定宽高比、0.5px 线? shapes 0.5px line .square { w…

    2025年12月24日
    000
  • 有哪些美观的开源数字大屏驾驶舱框架?

    开源数字大屏驾驶舱框架推荐 问题:有哪些美观的开源数字大屏驾驶舱框架? 答案: 资源包 [弗若恩智能大屏驾驶舱开发资源包](https://www.fanruan.com/resource/152) 软件 [弗若恩报表 – 数字大屏可视化组件](https://www.fanruan.c…

    2025年12月24日
    000
  • 网站底部如何实现飘彩带效果?

    网站底部飘彩带效果的 js 库实现 许多网站都会在特殊节日或活动中添加一些趣味性的视觉效果,例如点击按钮后散发的五彩缤纷的彩带。对于一个特定的网站来说,其飘彩带效果的实现方式可能有以下几个方面: 以 https://dub.sh/ 网站为例,它底部按钮点击后的彩带效果是由 javascript 库实…

    2025年12月24日
    000
  • 网站彩带效果背后是哪个JS库?

    网站彩带效果背后是哪个js库? 当你访问某些网站时,点击按钮后,屏幕上会飘出五颜六色的彩带,营造出庆祝的氛围。这些效果是通过使用javascript库实现的。 问题: 哪个javascript库能够实现网站上点击按钮散发彩带的效果? 答案: 根据给定网站的源代码分析: 可以发现,该网站使用了以下js…

    好文分享 2025年12月24日
    100
  • 产品预览卡项目

    这个项目最初是来自 Frontend Mentor 的挑战,旨在使用 HTML 和 CSS 创建响应式产品预览卡。最初的任务是设计一张具有视觉吸引力和功能性的产品卡,能够无缝适应各种屏幕尺寸。这涉及使用 CSS 媒体查询来确保布局在不同设备上保持一致且用户友好。产品卡包含产品图像、标签、标题、描述和…

    2025年12月24日
    100
  • 如何利用 echarts-gl 绘制带发光的 3D 图表?

    如何绘制带发光的 3d 图表,类似于 echarts 中的示例? 为了实现类似的 3d 图表效果,需要引入 echarts-gl 库:https://github.com/ecomfe/echarts-gl。 echarts-gl 专用于在 webgl 环境中渲染 3d 图形。它提供了各种 3d 图…

    2025年12月24日
    000
  • 如何在 Element UI 的 el-rate 组件中实现 5 颗星 5 分制与百分制之间的转换?

    如何在el-rate中将5颗星5分制的分值显示为5颗星百分制? 要实现该效果,只需使用 el-rate 组件的 allow-half 属性。在设置 allow-half 属性后,获得的结果乘以 20 即可得到0-100之间的百分制分数。如下所示: score = score * 20; 动态显示鼠标…

    2025年12月24日
    100
  • CSS 最佳实践:后端程序员重温 CSS 时常见的三个疑问?

    CSS 最佳实践:提升代码质量 作为后端程序员,在重温 CSS/HTML 时,你可能会遇到一些关于最佳实践的问题。以下将解答三个常见问题,帮助你编写更规范、清晰的 CSS 代码。 1. margin 设置策略 当相邻元素都设置了 margin 时,通常情况下应为上一个元素设置 margin-bott…

    2025年12月24日
    000

发表回复

登录后才能评论
关注微信