当前位置:

首页 > 编程开发 > Go语言实现HTTP请求重试工具封装方法

Go语言实现HTTP请求重试工具封装方法

最简重试逻辑需用net/http+time.Sleep实现:捕获超时、连接类错误重试,4xx错误不重试;用context.WithTimeout控制单次超时;每次重试前sleep并指数退避;每次新建*http.Request。

本文目录

    最简重试逻辑需用 net/http + time.Sleep 实现:捕获超时、连接类错误重试,4xx 错误不重试;用 context.WithTimeout 控制单次超时;每次重试前 sleep 并指数退避;每次新建 *http.Request。

    如何在Golang中制作一个简单的HTTP请求重试工具 Go语言封装策略

    用 net/http + time.Sleep 实现最简重试逻辑

    Go 标准库不自带 HTTP 重试,得自己套一层循环。核心是捕获 error 并判断是否值得重试,而不是无脑重试所有失败。

    常见错误现象:Get "https://api.example.com": context deadline exceeded、connection refused、Client.Timeout exceeded —— 这些适合重试;而 401 Unauthorized 或 404 Not Found 一般不该重试。

    • 用 context.WithTimeout 控制单次请求超时,别依赖 http.Client.Timeout 全局设死
    • 重试前必须 time.Sleep,否则可能瞬间打爆下游;推荐从 100ms 开始指数退避(如 100ms → 200ms → 400ms)
    • 别在循环里复用同一个 *http.Request:它内部带 body 和 context,第二次调用会报 http: Request.Body is nil

    示例关键片段:

    for i := 0; i < maxRetries; i++ {
        req, _ := http.NewRequestWithContext(ctx, "GET", url, nil)
        resp, err := client.Do(req)
        if err == nil && resp.StatusCode < 500 {
            return resp, nil
        }
        if i < maxRetries-1 {
            time.Sleep(time.Duration(100*math.Pow(2, float64(i))) * time.Millisecond)
        }
    }

    封装成可复用的 RetryClient 类型时要注意什么

    直接写函数也能用,但多人协作或项目变大后,封装成结构体更可控。重点不是“怎么定义 struct”,而是字段设计是否暴露了不该暴露的细节。

    使用场景:需要统一控制重试次数、退避策略、错误过滤规则,且不同 API 调用需差异化配置(比如文件上传不重试 500,但查询接口要重试)。

    • MaxRetries 建议设为 3~5,默认 3;设太大容易掩盖真实故障
    • 别把 http.Client 嵌入结构体并导出——外部修改其 Transport 或 Timeout 会破坏重试语义;应该只暴露 Do() 方法
    • 加一个 ShouldRetry 函数字段,类型为 func(*http.Response, error) bool,比硬编码判断更灵活
    • 避免在 Do() 内部 new http.Client:连接复用失效,CPU 和 fd 消耗陡增

    为什么不用第三方库如 backoff 或 retryablehttp

    这些库功能全,但引入后常带来两个隐性成本:依赖版本冲突、默认行为不符合业务预期(比如自动重试 5xx 且不区分 500/503)。

    性能影响:标准库 net/http 已经足够快,第三方封装如果在每次重试都新建 http.Client 或滥用 sync.Pool,反而降低吞吐。

    • backoff.Retry 默认用 ExponentialBackOff,但它的初始间隔是 100ms,最大间隔 1s —— 对内网服务可能太保守,对海外 API 又可能太激进
    • retryablehttp 的 CheckRetry 回调接收 *http.Response,但首次请求失败时 resp 是 nil,容易 panic,得手动判空
    • 如果你只需要「失败后等 200ms 再试一次」,写 10 行代码比配 5 个回调更可靠

    重试时最容易被忽略的副作用

    HTTP 方法语义不是装饰:对 POST / PUT / DELETE 盲目重试,可能造成重复下单、库存扣双倍、资源删两次。

    兼容性影响:有些老服务不支持 idempotency-key 头,也没实现幂等逻辑,此时重试等于制造数据异常。

    • GET / HEAD 请求天然幂等,可放心重试;其他方法必须先确认服务端是否支持幂等(看文档或加 X-Idempotency-Key)
    • 如果请求带 body(如 JSON),重试前要确保 req.Body 可重读 —— 用 bytes.NewReader 包一层原始数据,别传 strings.NewReader 后反复用
    • 日志里务必打出重试次数和原始错误,否则线上出问题时分不清是第几次失败,还是根本没走重试逻辑

    真正难的从来不是“怎么加重试”,而是“哪些请求能重试、重试几次、等多久、失败后怎么兜底”。这些决策没法靠工具自动做,得贴着业务逻辑写。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    llama.cpp b12441/b12442/b12448/b12449/b12451/b12452/b12453/b12455/b12456 对比?
    llama.cpp b12441/b12442/b12448/b12449/b12451/b12452/b12453/b12455/b12456 对比?

    llama.cpp b12441、b12442、b12448、b12449、b12451、b12452、b12453、b12455、b12456 均为预发布,涉及后端、聊天模板、设备参数、界面与音频,按场景对应各构建。

    ChatGPT for Academic Researchers如何看待下一轮名额和试点研究结果
    ChatGPT for Academic Researchers如何看待下一轮名额和试点研究结果

    ChatGPT for Academic Researchers 的五万份资助面向下一轮合格申请,全计划二十万人是长期覆盖目标。试点调查另有独立样本与证据口径。

    llama.cpp b12457 的 OpenCL A7 内核有哪些适用条件?
    llama.cpp b12457 的 OpenCL A7 内核有哪些适用条件?

    llama.cpp b12457 为 OpenCL 的 A7 路径增加 Q4_K 非 MoE 二进制内核,说明后端、量化及模型执行路径的适用范围。

    ChatGPT for Healthcare的软件权限与提供范围怎样判断
    ChatGPT for Healthcare的软件权限与提供范围怎样判断

    ChatGPT for Healthcare 将代理、搜索和医疗插件放在同一产品体系中。开通资格与组织设置决定成员能看到哪些工具。

    GitHub MCP Server v2.2.0 的技能、自动化与告警分别改变了什么?
    GitHub MCP Server v2.2.0 的技能、自动化与告警分别改变了什么?

    GitHub MCP Server v2.2.0 提供可选的过滤技能目录、代理自动化工具和秘密扫描告警隐藏参数。

    OpenBot v1.1.0-rc.1 测试升级涉及哪些兼容性变化?
    OpenBot v1.1.0-rc.1 测试升级涉及哪些兼容性变化?

    OpenBot v1.1.0-rc.1 启动时执行不可逆数据库迁移,PostgreSQL 采用两个受限角色,早期 API 迁至 /api/v2/。

    open-code-review v1.13.11 的分支会话与 Move 规则适用于什么场景?
    open-code-review v1.13.11 的分支会话与 Move 规则适用于什么场景?

    open-code-review v1.13.11 支持按分支筛选现有会话,增加 Move 审查规则,并修正路径、MCP 配置及部分失败状态显示。

    GitHub Desktop 3.6.12-beta2 的仓库切换列表有什么变化?
    GitHub Desktop 3.6.12-beta2 的仓库切换列表有什么变化?

    GitHub Desktop 3.6.12-beta2 在同一主机涉及多个账号时按仓库关联账号分组,并减少两项 Copilot 操作中的响应格式失败。

    GitHub Copilot CLI 1.0.113-1预发布版内置浏览器工具有什么管理边界
    GitHub Copilot CLI 1.0.113-1预发布版内置浏览器工具有什么管理边界

    GitHub Copilot CLI 1.0.113-1预发布版中的浏览器控制针对内置 Browser Use,由管理员通过托管设置管理。

    Qwen Code v0.27.4-nightly.20261116.eb3a599ef3 如何区分默认循环与配置覆盖?
    Qwen Code v0.27.4-nightly.20261116.eb3a599ef3 如何区分默认循环与配置覆盖?

    Qwen Code v0.27.4-nightly.20261116.eb3a599ef3 调整终端、无界面会话和子代理的默认共享循环,并保留命令确认中的完整命令。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。