Golang实战：如何编写一个支持函数重试的装饰器-Golang-PHP中文网

go中无装饰器语法，需用高阶函数模拟重试逻辑，核心是分离重试与业务逻辑；应避免硬编码循环、忽略context取消、滥用reflect，推荐用闭包封装带指数退避和上下文控制的withretry函数。

golang实战：如何编写一个支持函数重试的装饰器

Go 里没有装饰器，但可以用函数式封装模拟

Go 语言本身不支持 Python 那种 @decorator 语法，所谓“重试装饰器”本质是返回新函数的高阶函数。关键不是语法糖，而是把重试逻辑和业务逻辑干净分离。

常见错误是直接在原函数里硬塞 for 循环或递归调用，导致测试难、超时控制失效、错误类型被吞掉。正确做法是让重试逻辑只关心「怎么重试」，不碰「做什么」。

retry.Do 这类工具函数适合简单场景，但无法包裹已有函数签名；你需要的是 retry.Wrap 这类返回 func() error 或带参数闭包的封装
如果原函数带参数（比如 func(id string, timeout time.Duration) (string, error)），必须用闭包捕获参数，不能试图“泛化”所有函数签名——Go 没有泛型函数重载，硬搞会写出大量重复模板代码
别用 reflect 动态调用：性能差、堆栈丢失、panic 不易捕获，且绝大多数重试场景参数固定可预知

如何实现一个带指数退避和上下文取消的重试包装器

生产环境最常踩的坑是忽略 context.Context：重试过程中用户已取消请求，但 goroutine 还在傻等下次重试。真正的重试控制必须和 context 绑定。

以下是一个轻量但可用的封装示例（不依赖第三方库）：

func WithRetry(fn func() error, opts ...RetryOption) func() error {
    cfg := defaultRetryConfig()
    for _, opt := range opts {
        opt(cfg)
    }
    return func() error {
        var lastErr error
        for i := 0; i

cfg.ctx 必须由调用方传入，不能在包装器里新建 context.Background()，否则取消信号进不来
sleepDur 计算后应做上限限制（比如 min(sleepDur, 30*time.Second)），避免第 10 次重试等 17 分钟
使用 rand.Int63n 前要 rand.Seed(time.Now().UnixNano())，但更推荐从外部传入 *rand.Rand 实例，方便测试时固定随机序列

重试判定逻辑必须显式声明，不能只看 error 是否为 nil

很多同学默认「非 nil error 就重试」，结果数据库唯一约束失败、用户输入校验失败也被反复重试，浪费资源还误导前端。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

真正需要重试的错误往往有明确特征：

网络类：net.OpError、os.SyscallError（底层 connect timeout）、grpc.Status.Code() == codes.Unavailable
临时服务不可用：strings.Contains(err.Error(), "i/o timeout") 或自定义错误类型如 IsTransient(err)
绝不能重试：errors.Is(err, sql.ErrNoRows)、errors.Is(err, ErrInvalidInput)、HTTP 400/401/403/404 等客户端错误

建议把重试判定抽成独立函数，例如：

func ShouldRetry(err error) bool {
    if err == nil {
        return false
    }
    var netErr net.Error
    if errors.As(err, &netErr) && netErr.Timeout() {
        return true
    }
    if s, ok := status.FromError(err); ok && s.Code() == codes.Unavailable {
        return true
    }
    return false
}

然后在重试循环中显式调用它，而不是无差别重试。