史上最细gRPC(Go)入门教程(九)---配置retry自动重试

Go语言请求重试机制实战与retry-go库解析 在网络编程中,请求重试机制是处理临时性故障的关键技术。其核心原理是通过自动重试来应对网络抖动、服务短暂不可用等场景,提升系统容错能力。从技术实现来看,优秀的重试策略需要支持可配置间隔、错误过滤和上下文控制等特性。Go语言的retry-go库以其简洁的设计哲学,提供了灵活的重试方案,特别适合处理HTTP请求、数据库操作等分布式系统常见场景。通过指数退避算法和错误类型判断,开发者可以有效避免重试风暴,同时结合监控指标实现系统可观测性。这些实践对于构建高可用的微服务架构具有重要意义,特别是在支付系统、API网关等 阅读详情

来自:指月 https://lixueduan.com

原文:https://lixueduan.com/post/grpc/09-retry/

本文主要记录了如何使用 gRPC 中的 自动重试功能。


如果你对云原生技术充满好奇,想要深入了解更多相关的文章和资讯,欢迎关注微信公众号。

扫描下方二维码或搜索公众号【探索云原生】即可订阅


1. 概述

gRPC 系列相关代码见 Github

gRPC 中已经内置了 retry 功能,可以直接使用,不需要我们手动来实现,非常方便。

2. Demo

Server

为了测试 retry 功能,服务端做了一点调整。

记录客户端的请求次数,只有满足条件的那一次(这里就是请求次数模4等于0的那一次)才返回成功,其他时候都返回失败。

package main

import (
	"context"
	"flag"
	"fmt"
	"log"
	"net"
	"sync"

	"google.golang.org/grpc"
	"google.golang.org/grpc/codes"
	"google.golang.org/grpc/status"

	pb "github.com/lixd/grpc-go-example/features/proto/echo"
)

var port = flag.Int("port", 50052, "port number")

type failingServer struct {
	pb.UnimplementedEchoServer
	mu sync.Mutex

	reqCounter uint
	reqModulo  uint
}

// maybeFailRequest 手动模拟请求失败 一共请求n次,前n-1次都返回失败,最后一次返回成功。
func (s *failingServer) maybeFailRequest() error {
	s.mu.Lock()
	defer s.mu.Unlock()
	s.reqCounter++
	if (s.reqModulo > 0) && (s.reqCounter%s.reqModulo == 0) {
		return nil
	}

	return status.Errorf(codes.Unavailable, "maybeFailRequest: failing it")
}

func (s *failingServer) UnaryEcho(ctx context.Context, req *pb.EchoRequest) (*pb.EchoResponse, error) {
	if err := s.maybeFailRequest(); err != nil {
		log.Println("request failed count:", s.reqCounter)
		return nil, err
	}

	log.Println("request succeeded count:", s.reqCounter)
	return &pb.EchoResponse{Message: req.Message}, nil
}

func main() {
	flag.Parse()

	address := fmt.Sprintf(":%v", *port)
	lis, err := net.Listen("tcp", address)
	if err != nil {
		log.Fatalf("failed to listen: %v", err)
	}
	fmt.Println("listen on address", address)

	s := grpc.NewServer()

	// 指定第4次请求才返回成功,用于测试 gRPC 的 retry 功能。
	failingservice := &failingServer{
		reqModulo: 4,
	}

	pb.RegisterEchoServer(s, failingservice)
	if err := s.Serve(lis); err != nil {
		log.Fatalf("failed to serve: %v", err)
	}
}

Client

客户端则是建立连接的时候通过grpc.WithDefaultServiceConfig()配置好 retry 功能。

package main

import (
	"context"
	"flag"
	"log"
	"time"

	pb "github.com/lixd/grpc-go-example/features/proto/echo"
	"google.golang.org/grpc"
)

var (
	addr = flag.String("addr", "localhost:50052", "the address to connect to")
	// 更多配置信息查看官方文档: https://github.com/grpc/grpc/blob/master/doc/service_config.md
	// service这里语法为<package>.<service> package就是proto文件中指定的package,service也是proto文件中指定的 Service Name。
	// method 可以不指定 即当前service下的所以方法都使用该配置。
	retryPolicy = `{
		"methodConfig": [{
		  "name": [{"service": "echo.Echo","method":"UnaryEcho"}],
		  "retryPolicy": {
			  "MaxAttempts": 4,
			  "InitialBackoff": ".01s",
			  "MaxBackoff": ".01s",
			  "BackoffMultiplier": 1.0,
			  "RetryableStatusCodes": [ "UNAVAILABLE" ]
		  }
		}]}`
)

func main() {
	flag.Parse()
	conn, err := grpc.Dial(*addr, grpc.WithInsecure(), grpc.WithDefaultServiceConfig(retryPolicy))
	if err != nil {
		log.Fatalf("did not connect: %v", err)
	}
	defer func() {
		if e := conn.Close(); e != nil {
			log.Printf("failed to close connection: %s", e)
		}
	}()

	c := pb.NewEchoClient(conn)

	ctx, cancel := context.WithTimeout(context.Background(), 1*time.Second)
	defer cancel()

	reply, err := c.UnaryEcho(ctx, &pb.EchoRequest{Message: "Try and Success"})
	if err != nil {
		log.Fatalf("UnaryEcho error: %v", err)
	}
	log.Printf("UnaryEcho reply: %v", reply)
}

需要注意的是其中的配置信息:

{
		"methodConfig": [{
		  "name": [{"service": "echo.Echo","method":"UnaryEcho"}],
		  "retryPolicy": {
			  "MaxAttempts": 4,
			  "InitialBackoff": ".01s",
			  "MaxBackoff": ".01s",
			  "BackoffMultiplier": 1.0,
			  "RetryableStatusCodes": [ "UNAVAILABLE" ]
		  }}]
}
  • name 指定下面的配置信息作用的 RPC 服务或方法
    • service:通过服务名匹配,语法为<package>.<service> package就是proto文件中指定的package,service也是proto文件中指定的 Service Name。
    • method:匹配具体某个方法,proto文件中定义的方法名。

主要关注 retryPolicy,重试策略

  • MaxAttempts:最大尝试次数
  • InitialBackoff:默认退避时间
  • MaxBackoff:最大退避时间
  • BackoffMultiplier:退避时间增加倍率
  • RetryableStatusCodes:服务端返回什么错误码才重试

重试机制一般会搭配退避算法一起使用。

即假设第一次请求失败后,等1秒(随便取的一个数)再次请求,又失败后就等2秒在请求,一直重试直达超过指定重试次数或者等待时间就不在重试。

如果不使用退避算法,失败后就一直重试只会增加服务器的压力。如果是因为服务器压力大,导致的请求失败,那么根据退避算法等待一定时间后再次请求可能就能成功。反之直接请求可能会因为压力过大导致服务崩溃。

Run

先启动服务端

lixd@17x:~/17x/projects/grpc-go-example/features/retry/server$ go run main.go 
listen on address :50052
2021/02/17 17:35:29 request failed count: 1

在启动客户端

lixd@17x:~/17x/projects/grpc-go-example/features/retry/client$ go run main.go 
2021/02/17 17:35:29 UnaryEcho error: rpc error: code = Unavailable desc = maybeFailRequest: failing it
exit status 1

emmm 并没有重试。。。

开启重试

查看文档后发现是需要设置环境变量。

查看文档后发现是需要设置环境变量。

查看文档后发现是需要设置环境变量。

这个比较坑,看了好多文章都没提到这个。

https://github.com/grpc/grpc-go/issues/3020

lixd@17x$ export GRPC_GO_RETRY=on
lixd@17x$ echo $GRPC_GO_RETRY
on

然后重新启动服务端和客户端

lixd@17x:~/17x/projects/grpc-go-example/features/retry/server$ go run main.go 
listen on address :50052
2021/02/17 17:37:55 request failed count: 1
2021/02/17 17:37:55 request failed count: 2
2021/02/17 17:37:55 request failed count: 3
2021/02/17 17:37:55 request succeeded count: 4
lixd@17x:~/17x/projects/grpc-go-example/features/retry/client$ go run main.go 
2021/02/17 17:37:55 UnaryEcho reply: message:"Try and Success"

现在重试功能就生效了。

前3次都失败了,且返回错误码是客户端重试策略中指定的UNAVAILABLE,所以都进行了重试,直到第4次成功了就不在重试了。

当然,第4次已经是最大尝试次数了,就算失败也不会重试了。

3. 小结

gRPC 中内置了 retry 功能,使用比较简单。

  • 1)客户端建立连接时通过grpc.WithDefaultServiceConfig(retryPolicy)指定重试策略
  • 2)环境变量中开启重试:export GRPC_GO_RETRY=on

如果你对云原生技术充满好奇,想要深入了解更多相关的文章和资讯,欢迎关注微信公众号。

扫描下方二维码或搜索公众号【探索云原生】即可订阅


golang工程组件篇:高性能RPC框架gRPC之Retry与LoadBalance 当该请求到达客户端时,客户端会根据RoundRobin策略选择一个合适的服务节点,并将请求转发给该节点处理。当一个请求到达客户端时,客户端会根据预定义的策略选择一个合适的服务节点,并将请求转发给该节点处理。如果请求失败,客户端会自动进行多次尝试,并在每次尝试之间等待一定的时间。当一个请求失败时,客户端会根据预定义的策略自动进行多次尝试,并且可以在每次尝试之间设置延迟时间。在本文中,我将重点介绍gRPC框架中的Retry和LoadBalance这两个重要概念,并探讨它们如何提高系统的可靠性和性能。 阅读详情

相关推荐

12. 【gRPC系列学习】失败重试Retry原理

gRPC失败重试原理

菜鸟的博客 1226

gRPC 高级特性之 重试机制

gRPC 重试机制、重试原理、重试配置模板 grpc-previous-rpc-attempts

u013433591的博客 4713

13. 【gRPC系列学习】失败重试Retry实战

gRPC 失败重试实战

菜鸟的博客 837

grpc 重试机制

这也是grpc官方库里的示例代码,其他讲retry重试的基本也都是参照这种方法。但是本地配置之后没生效。换用下边第二种方式之后问题解决。参照下边连接里的示例代码,先在opts里配置重试规则,然后grpc.Dial方法里应用这个规则就可以。相对官方的方法这里的方法配置起来比较简单,而且配置完实验马上就生效了。

Haikuotiankong11111的博客 916

Go gRPC实战(三) 客户端开发与拦截器

这篇讲了客户端的拦截器、重试和metadata。核心要点是拦截器顺序很关键,重试放最外层,保证每次重试走完整中间件链。下一篇进入流式通信实战,讲双向流在实时场景中的应用,包括背压控制和keepalive配置。

白话机器学习 146

go-retry:转到库以使用可配置的退避重试

重试 重试是一个Go库,用于促进重试逻辑和退避。它具有高度的可扩展性,可以完全控制重试的方式和时间。您还可以通过实现Backoff接口来编写自己的自定义退避函数。 特征 可扩展-受Go内置HTTP软件包的启发,此Go backoff and retry库可通过中间件进行扩展。您可以编写自定义退避功能或使用提供的过滤器。 独立-除了Go标准库外,没有任何外部依赖关系,这意味着它不会膨胀您的项目。 并发-除非另有说明,否则所有内容均可安全地并发使用。 上下文感知-使用本地Go上下文控制取消。 用法 这是使用Go的database/sql软件包连接到数据库的示例用法: package main import ( "context" "database/sql" "log" "time" "github.com/sethvargo/go-retry" ) func main

grpc进阶篇之retry拦截器

前言 之前还在学校的时候,写过一篇go gRPC初体验,算是初步预习了一下grpc的用法,知道了如何使用grpc实现简单的rpc调用,当时写了一个demo,跑通了之后就觉得,应该够用了,然而到了公司之后才发现,grpc,远不止于此。。。于是我决定好好总结一下grpc的一些进阶知识,结合公司项目里的实际用法,分享给大家,帮助初学者们更好的掌握grpc。本篇,就先介绍一下grpc的retry拦截器。 为什么要retry retry很好理解,就是重试,为什么需要重试?首先,grpc常用于移动端和跨机房调用的

djqueen的博客 3119

retry:Go 中重试行为的接口和各种实现

重试行为的各种实现的接口和集合,旨在易于使用和组合。 该界面的灵感来自中的 。 除了相当有用之外,这个库还很好地说明了接口在 go 中的用处。 使用单一策略或将几个组合在一起,轻松完成通常有点繁琐的工作。 一些例子: // A very basic example. strategy := & retry. CountStrategy { Tries : 3 } for done := false ; ! done && strategy . Next () { done = trySomething () } // Compose a few strategies together // Try not more than 3 times, with a 100ms delay between attempts strategy := & retry. All { & re

Go 微服务架构设计与服务治理实战:超时重试何时应当停止

分布式系统的优雅之处,在于懂得在合适的时候承认失败。遇到响应慢不要盲目重试。用 Context 把生命周期贯穿到底,用 Jitter 把并发请求打散,用 Retry Budget 阻止重试风暴,用精确错误码切断非幂等调用。做好这四点,你的 Go 微服务系统才能在高峰期高枕无忧。

好代码自己会说话,烂代码才需要注释来圆谎 4189

Mem0 vs LangMem vs Letta:三大AI记忆框架实战对比(附代码示例)

本文深入对比了Mem0、LangMem和Letta三大AI记忆框架的核心特性与适用场景。Mem0提供开箱即用的记忆管理服务,适合快速集成;LangMem深度融入LangGraph生态,适合复杂工作流;Letta则采用虚拟内存系统,旨在突破上下文窗口限制。文章通过实战代码示例,为开发者选择适合其业务需求的AI记忆解决方案提供了清晰指南。

g9h0i1的博客 681

Unity ECS 之 Entitas 的简单介绍,插件下载、导入,和简单使用(一篇文入门搞懂ECS是什么)

Unity ECS 之 Entitas 的简单介绍,插件下载、导入,和简单使用(一篇文入门搞懂ECS是什么) 目录 Unity ECS 之 Entitas 的简单介绍,插件下载、导入,和简单使用(一篇文入门搞懂ECS是什么) 一、简单介绍 二、一些专有项简介 Entity Context Group Collector Matcher System Feature 三、注意实现 四、ECS 的下载 Github 上下载 Unity Asset Store 中下载 U...

仙魁XAN 7780

dsh-web 插件全家桶:一条命令装齐任务看板、Git 图谱与 62 款皮肤

你有没有过这种体验:对话窗口开着,却只能盯着一条一条的原始消息干等,想给任务排个"每周一早上自动跑"却无处下手,分支一多就看不清谁在什么时候动了哪行代码,想换个界面颜色还得自己扒 CSS。dsh-web 就是冲着这些"不够用、看不清、不好看"来的——它是 DeepSeek Harness(DSH)Web 界面的插件与皮肤全家桶,任务看板、Git 图谱、SSH 运维、Token 账单和 62 款主题

gitblog_01410的博客 515

华为OD技术面八股文_C++_02

汇总华为OD面试C++方面计数八股文真题,提供详细解答。

qq_45776114的博客 768

gRPC-Go基础(5)middleware

if err!= nil {类似于grpc_zap.UnaryServerInterceptor,我们在建立服务的时候设置拦截器。)),)),在handler之前的部分,先注册的拦截器先执行;在handler之后的部分,先注册的拦截器后执行;原因是,在ChainUnaryServer函数中,是倒序将注册的拦截器函数一个个包装,最里面的就是核心的处理逻辑,故而会展现出以上的规则。

ldxxxxll的博客 1657

一点击打印电脑就卡死?资源管理器停止工作的解决方法

Windows11共享的HP1022n打印机导致客户端打印时资源管理器崩溃卡死,电脑停止工作。

gary18的专栏 593

uniapp(全端兼容) - 详细实现唤起手机摄像头对商品进行拍照识别功能,在uniapp全平台小程序/h5网页/安卓苹果app做商品扫描识别效果,仿京东淘宝扫描识别功能效果(提供示例代码,开箱即用)

uniapp,微信小程序,移动端h5网页,手机H5网站,安卓苹果app软件,拍照识图功能,vue前端实现商品拍照识别,uniapp详细实现调用手机摄像头拍照识别商品,uniapp拍照识图插件组件实例代码,uni-app实现京东淘宝拼多多点击拍照识图功能,uniapp怎么做电商app的拍照识别图片上的商品功能,uniapp仿淘宝拍照识图,uniapp仿京东拍照识图,调用后置摄像头拍照扫描图片上的物品,手机摄像头拍照并拖动一个区域进行识别,前端怎么做识别图片的交互效果,uniapp(全端兼容) - 详细实现唤起

✅ 精选推荐文章 4409

如何快速实现gRPC限流保护:go-grpc-middleware限流器终极指南

在微服务架构中,gRPC限流是保护服务不被压垮的关键技术。go-grpc-middleware限流器提供了简单高效的解决方案,帮助开发者在gRPC服务中轻松实现请求频率控制,防止系统过载。😊 ## 为什么需要gRPC限流保护? 在分布式系统中,突发的流量高峰可能导致服务雪崩。gRPC限流器就像是服务的"安全阀",当请求超过预设阈值时,自动拒绝多余请求,保证核心业务正常运行。go-grpc-m

gitblog_01404的博客 646

C#上位机实战:PLC与检测设备无缝对接,构建产品质量实时判定系统

本文分享了基于C#开发的汽车零部件质量检测系统实现经验。系统采用三层架构:设备层(PLC/视觉相机/三坐标)、通信层(OPC UA/SDK/串口)和应用层(数据采集/判定/存储)。重点解决了三大技术难点:1)通过OPC UA订阅模式将PLC通信延迟从500ms降至50ms;2)反编译厂商Demo破解视觉SDK对接难题;3)采用时间戳+产品ID实现多设备数据同步。系统上线后质检人员减少67%,误判率降至0.5%,数据追溯效率显著提升。文章强调工业场景下稳定性优先于技术复杂度,实用经验值得借鉴。

这里只有干货:从 Modbus 通信到 MES 对接,从 YOLO 训练到工控机部署,带你搞定工业软件开发全流程。 804

gRPC -- Guides -Retry

摘要:gRPC的重试机制通过OpenCensus/OpenTelemetry支持,显著提升服务可靠性。其核心包括:自动重试可恢复的瞬时故障(如网络波动),支持透明重试与显式策略配置(含指数退避、随机抖动和限流控制)。关键特性包括按方法粒度的策略定制(最大尝试次数、退避参数、可重试状态码)以及实时监控指标(如调用耗时、消息大小)。该机制与对冲策略互补,需注意透明重试可能增加网络负载,建议通过服务配置平衡重试积极性与系统负载。各语言SDK均提供实现支持。

dengfuma的专栏 959

目标检测: yolo26在RK3588上部署

YOLO26发布:端到端目标检测新突破 摘要:Ultralytics最新发布的YOLO26算法采用原生端到端设计,无需NMS后处理,显著提升推理效率。该模型基于三大核心原则: 简洁性:消除NMS步骤,实现直接预测 部署效率:简化集成流程,降低延迟 训练创新:引入MuSGD混合优化器,加速收敛 部署教程显示,YOLO26可适配RK3588等边缘设备,通过ONNX转换和RKNN工具链实现高效部署。其创新架构特别优化了分割、姿态估计等专业任务,标志着目标检测技术的重要革新。 (字数:149)

qianxun 1456

Android 13.0 开机启动优化之PMS扫描apk耗时相关功能优化

在android13.0的系统rom定制化开发中,在系统中开发产品时,会根据客户要求内置第三方app,这时如果内置app过多,或者安装的app过多,在系统开机的过程中 在pms扫描安装app的时候,就会比较耗时,这时候就需要优化下pms扫描安装app这块的功能代码,用多线程来实现pms扫描安装app,来加快开机时间,接下来 来实现这个功能

安卓兼职framework和app工程师的博客 1335

终极指南:go-grpc-middleware拦截器链式调用顺序深度解析

在构建Golang gRPC服务时,拦截器(Interceptor)是实现横切关注点的强大工具。go-grpc-middleware作为Golang生态中最受欢迎的gRPC中间件库,提供了拦截器链式调用功能,让开发者能够灵活组合认证、日志、限流等功能。本文将深入解析拦截器链式调用的执行顺序原理,帮助你轻松掌握这一核心技术。 ## 拦截器链式调用的基本概念 gRPC拦截器分为Unary拦截器和S

gitblog_01429的博客 697

WINCC7.3破解文件

WINCC7.3硬件够破解文件,有需要的下载!WINCC7.3硬件够破解文件,有需要的下载!

Reactive-gRPC多语言互操作:Java与Go服务通信实战指南

Reactive-gRPC是一个强大的开源库,它结合了gRPC的高性能通信和Reactive Streams的响应式编程模型,为构建现代化的分布式系统提供了完整的解决方案。💡 在微服务架构中,多语言互操作是一个常见需求,而Reactive-gRPC正是解决这一挑战的利器。本文将详细介绍如何使用Reactive-gRPC实现Java与Go服务之间的高效通信,帮助开发者构建更灵活、更高效的分布式系统

gitblog_00729的博客 882

VC中sqlite的使用

在VC中对sqlite的使用,实现数据库大批数据的快速插入,读取数据库中的数据在ListCtrl中显示

LinePhone3.2.7(android端最新版本) sip客户端

SIP客户端For android:LinePhone3.2.7(最新版本),官网地址:http://www.linphone.org/

Go中的重试机制:如何优雅实现容错与服务自愈?

掌握Go重试机制,提升服务稳定性。本文详解Go中重试机制的实现方法,涵盖网络请求、RPC调用等常见场景,结合指数退避与上下文控制,实现优雅容错与自愈。代码简洁可靠,适用于微服务高可用设计,值得收藏。

QuickProceed的博客 314

win10 跳过U8环境检测的IE WebControls.rar

win10 安装u8的时候 提示IE WebControls 不通过,这个工具可以欺骗u8的检查。 跳过U8环境检测的IE WebControls。提示导入失败后,重新检测通过。

别再手动重试了,Python装饰器自动化重试方案一文搞定

轻松解决函数执行不稳定问题,本文详解Python装饰器实现函数重试机制,适用于网络请求、文件读写等易失败场景。通过简洁代码示例展示重试间隔、次数控制等核心逻辑,提升程序健壮性。方法实用,值得收藏。

ProcePerch的博客 409

Golang核心特性与高并发实践指南

Go语言作为云计算时代的明星语言,以其高效的并发模型和简洁的设计哲学著称。通过轻量级goroutine和channel机制,开发者可以轻松构建高并发系统,相比传统线程模型可节省大量内存资源。在内存管理方面,Go的垃圾回收机制经过持续优化,STW停顿时间已控制在毫秒级,配合pprof工具能有效识别内存热点。典型应用场景包括微服务通信(gRPC)、消息队列(Kafka集成)和Web服务(gin框架)等分布式系统,其中接口的隐式实现特性为代码复用提供了极大灵活性。本文通过生产者-消费者模式等具体案例,详解如何通过

weixin_34160277的博客 470
上一篇: 史上最细gRPC(Go)入门教程(八)---使用context进行超时控制
下一篇: 史上最细gRPC(Go)入门教程(十)------gRPC压测工具ghz
探索云原生
博客等级 码龄9年 730粉丝 131原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值