Golang配置gRPC双向流与服务端推送教程
一分耕耘,一分收获!既然都打开这篇《Golang如何配置gRPC双向流与服务端推送》,就坚持看下去,学下去吧!本文主要会给大家讲到等等知识点,如果大家对本文有好的建议或者看到有不足之处,非常欢迎大家积极提出!在后续文章我会继续更新Golang相关的内容,希望对大家都有所帮助!
要支持Golang环境中的gRPC流式通信,核心在于正确定义proto文件并实现服务端与客户端的处理逻辑。一、在.proto文件中使用stream关键字定义流式接口,如双向流需在请求和响应前均添加stream;二、服务端通过Recv()接收消息,通过Send()发送响应,并循环处理直到收到EOF;三、客户端应分goroutine处理Recv()和Send(),发送完毕调用CloseSend();四、注意处理超时、断开连接、流关闭及性能优化等问题。
Golang环境要支持gRPC流式通信,核心在于定义好proto文件中的流式接口,并在服务端和客户端正确实现对应的处理逻辑。本文主要讲两个场景:服务端推送(Server Streaming)和双向流(Bidirectional Streaming)的配置方法与注意事项。

一、proto文件中定义流式接口
gRPC的流式通信是通过在.proto
文件中使用stream
关键字来声明的。常见的几种流式方式包括:

- Server streaming:服务端返回多个响应
- Client streaming:客户端发送多个请求
- Bidirectional streaming:双方都收发多个消息
比如一个双向流的接口可以这样写:
syntax = "proto3"; package example; service Greeter { rpc Chat (stream MessageRequest) returns (stream MessageResponse); } message MessageRequest { string content = 1; } message MessageResponse { string reply = 1; }
这个例子中,Chat
方法允许客户端和服务端持续发送和接收消息,适用于聊天类或实时通知类场景。

定义proto时要注意:
stream
只能用于参数或返回值- 双向流需要两边都加
stream
- 使用
protoc
生成代码时确保安装了正确的插件,如protoc-gen-go-grpc
二、服务端实现流式处理逻辑
以Go语言为例,实现上述双向流的服务端逻辑大致如下:
type server struct{} func (s *server) Chat(stream pb.Greeter_ChatServer) error { for { req, err := stream.Recv() if err == io.EOF { return nil } if err != nil { return err } // 根据收到的消息构造回复 resp := &pb.MessageResponse{ Reply: "Received: " + req.Content, } // 向客户端发送响应 if err := stream.Send(resp); err != nil { return err } } }
这段代码的核心点在于:
- 使用
Recv()
接收客户端发来的每一条消息 - 使用
Send()
向客户端发送每条响应 - 循环处理直到客户端关闭连接(收到EOF)
注意:不要在goroutine里直接使用stream.Send或Recv,除非你做了同步控制。因为gRPC的流不是并发安全的。
三、客户端发起双向流请求
客户端的实现也很简单,主要流程是启动一个流,然后在一个goroutine中持续读取服务端的返回,另一个goroutine用来发送请求。
示例代码如下:
stream, err := client.Chat(context.Background()) if err != nil { log.Fatalf("Failed to open stream: %v", err) } // 单独协程读取服务端返回 go func() { for { resp, err := stream.Recv() if err == io.EOF { break } if err != nil { log.Printf("Error receiving message: %v", err) break } fmt.Println("Server says:", resp.Reply) } }() // 主协程发送消息给服务端 for i := 0; i < 5; i++ { msg := &pb.MessageRequest{ Content: fmt.Sprintf("Message %d", i), } if err := stream.Send(msg); err != nil { log.Printf("Error sending message: %v", err) break } time.Sleep(time.Second) } stream.CloseSend()
这里的关键点:
stream.Recv()
和stream.Send()
应该分开处理,避免阻塞- 发送完所有消息后记得调用
CloseSend()
,否则服务端会一直等待 - 处理错误和EOF的情况很重要,否则容易导致程序卡死
四、常见问题与优化建议
实际开发中可能会遇到一些坑,比如:
- 连接超时或断开:可以在上下文中设置合理的超时时间,或加入重连机制
- 流被意外关闭:检查是否提前调用了
CloseSend()
,或者服务端主动结束 - 性能瓶颈:如果消息量很大,考虑压缩数据或调整gRPC的传输限制(max-message-size)
另外,如果你要做服务端主动推送(不等客户端发消息),也可以用Server Streaming的方式,原理类似,只是proto中只对返回值加stream
即可。
基本上就这些。流式通信虽然比普通RPC复杂一点,但结构清晰、功能强大,适合实时性要求高的场景。只要proto定义清楚,服务端和客户端逻辑配合得当,用起来还是很顺手的。
今天带大家了解了的相关知识,希望对你有所帮助;关于Golang的技术知识我们会一点点深入介绍,欢迎大家关注golang学习网公众号,一起学习编程~

- 上一篇
- Java注解是什么?四大元注解详解

- 下一篇
- JS原型链机制全解析
-
- Golang · Go教程 | 3分钟前 | golang net/http Web表单提交 GET/POST请求 表单数据解析
- Golang实现简单表单提交教程
- 407浏览 收藏
-
- Golang · Go教程 | 8小时前 |
- Go中ResponseWriter传参方式解析
- 385浏览 收藏
-
- Golang · Go教程 | 8小时前 |
- Golang结构体字段安全访问方法
- 403浏览 收藏
-
- Golang · Go教程 | 8小时前 |
- Golang打造GitOps引擎,ArgoCD插件开发解析
- 361浏览 收藏
-
- Golang · Go教程 | 8小时前 |
- Golang实现UDP可靠传输,KCP协议集成详解
- 348浏览 收藏
-
- Golang · Go教程 | 8小时前 |
- Golang日志聚合ELK配置教程
- 329浏览 收藏
-
- Golang · Go教程 | 8小时前 |
- Go服务器优雅停机与消息通知方法
- 264浏览 收藏
-
- Golang · Go教程 | 8小时前 |
- Golang单测超时控制技巧解析
- 456浏览 收藏
-
- Golang · Go教程 | 8小时前 |
- Golang实现gRPC服务proto定义与生成
- 482浏览 收藏
-
- Golang · Go教程 | 9小时前 |
- CGO项目手动编译步骤详解
- 121浏览 收藏
-
- Golang · Go教程 | 9小时前 |
- Golang服务健康检查与监控方法
- 111浏览 收藏
-
- Golang · Go教程 | 9小时前 |
- Golang表格驱动测试与多输入优化技巧
- 288浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 512次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 499次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 484次学习
-
- 千音漫语
- 千音漫语,北京熠声科技倾力打造的智能声音创作助手,提供AI配音、音视频翻译、语音识别、声音克隆等强大功能,助力有声书制作、视频创作、教育培训等领域,官网:https://qianyin123.com
- 837次使用
-
- MiniWork
- MiniWork是一款智能高效的AI工具平台,专为提升工作与学习效率而设计。整合文本处理、图像生成、营销策划及运营管理等多元AI工具,提供精准智能解决方案,让复杂工作简单高效。
- 792次使用
-
- NoCode
- NoCode (nocode.cn)是领先的无代码开发平台,通过拖放、AI对话等简单操作,助您快速创建各类应用、网站与管理系统。无需编程知识,轻松实现个人生活、商业经营、企业管理多场景需求,大幅降低开发门槛,高效低成本。
- 822次使用
-
- 达医智影
- 达医智影,阿里巴巴达摩院医疗AI创新力作。全球率先利用平扫CT实现“一扫多筛”,仅一次CT扫描即可高效识别多种癌症、急症及慢病,为疾病早期发现提供智能、精准的AI影像早筛解决方案。
- 842次使用
-
- 智慧芽Eureka
- 智慧芽Eureka,专为技术创新打造的AI Agent平台。深度理解专利、研发、生物医药、材料、科创等复杂场景,通过专家级AI Agent精准执行任务,智能化工作流解放70%生产力,让您专注核心创新。
- 816次使用
-
- Golangmap实践及实现原理解析
- 2022-12-28 505浏览
-
- 试了下Golang实现try catch的方法
- 2022-12-27 502浏览
-
- 如何在go语言中实现高并发的服务器架构
- 2023-08-27 502浏览
-
- go和golang的区别解析:帮你选择合适的编程语言
- 2023-12-29 502浏览
-
- 提升工作效率的Go语言项目开发经验分享
- 2023-11-03 502浏览