讲师中心 微信公众号
AI工具推荐 视频效率加速

Echo框架基于SingleFlight防止缓存击穿实践

星杰君_9066

星杰君_9066

发布时间:2026-09-12 08:47:19

|

179人浏览过

|

来源于php中文网

原创

singleflight.Group 本身不防缓存击穿,仅做请求合并;真正起效需闭环“查缓存→miss后进Do→成功后写缓存”,且Group须全局复用、key需带命名空间前缀、loader内须用ctx控制超时并正确处理redis.Nil。

echo框架基于singleflight防止缓存击穿实践

singleflight.Group 防缓存击穿,在 Echo 中不是加个中间件就能完事——关键在于 Do 调用时机、loader 函数的上下文传播、以及空值与错误的区分处理。它不自动写缓存,也不跨实例生效,纯内存级合并,必须嵌入到你的业务查询路径里。

为什么不能在 Echo 中间件里统一 wrap cache Get?

中间件对每个请求都走一遍,但 singleflight.Do 必须和「缓存未命中 → 回源加载」这个逻辑强绑定。如果在中间件里无差别调用 Do("key", loader),会导致: - 所有请求(包括已命中的)都进 Do,徒增锁竞争开销 - loader 里没做缓存写入,结果只返回给当前请求,其他等待者拿到结果后仍不会落缓存 - 无法按 key 动态构造 loader(比如需从 c.Param("id") 提取),中间件缺乏路由上下文

loader 函数必须手动处理 context 超时和 redis.Nil

singleflight.Do 不透传 echo.Context,你得把 c.Request().Context() 显式传进去;同时 Redis 查询返回 redis.Nil 是正常现象,不是错误,不能直接当失败抛出:

Echo框架 5.1.0
Echo框架 5.1.0

Echo框架 5.1.0 版本源码包下载,适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。

下载
result, err, shared := sg.Do("user:123", func() (interface{}, error) {
    // ✅ 正确:用 ctx 控制 DB/Redis 超时
    val, err := rdb.Get(ctx, "user:123").Result()
    if errors.Is(err, redis.Nil) {
        // ✅ 空值要显式返回 (nil, nil),否则会被当错误兜底
        return nil, nil
    }
    if err != nil {
        return nil, err
    }
    return val, nil
})
  • errors.Is(err, redis.Nil) 必须用,不能写 err == redis.Nil(它是变量)
  • 返回 (nil, nil) 表示“查到空”,后续可走空值缓存逻辑;返回 (nil, someErr) 才是真错误,需按业务策略降级
  • loader 内部不做缓存写入,那是调用方的责任——等 Do 返回后,由第一个成功加载者执行 rdb.Set 和本地缓存填充

全局复用一个 singleflight.Group 实例,但 key 要带命名空间前缀

多个业务共用一个 Group 没问题,但 key 冲突会导致无关请求互相阻塞。比如用户服务和订单服务都用 "123" 当 key,就会串线:

  • ✅ 推荐 key 格式:"load:user:" + userID"load:order:" + orderID
  • ❌ 避免直接用 c.Param("id") 或原始 ID 字符串,尤其当不同接口可能传相同数字但语义不同(如 /users/123/posts/123
  • 不建议每次请求 new singleflight.Group,它内部用 map + mutex 管理等待队列,new 太多会泄漏 goroutine

最容易被忽略的是:singleflight 只解决「谁去查」,不解决「查完写哪」和「写失败怎么办」。同一个 key 的等待者共享 loader 返回值,但如果 loader 成功后写 Redis 失败,下次缓存又失效,整套逻辑就重来一遍——所以写缓存那步必须幂等且带重试,且不能放在 Do 外面由调用方统一做(否则只有第一个 goroutine 会写,其余等待者看不到新缓存)。

热门AI工具

更多
Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

更多
loomy官网入口地址合集
loomy官网入口地址合集

本专题汇总了 Loomy 桌面 AI 助理的官方入口地址合集及使用指南。提供 macOS 与 Windows 客户端下载 。Loomy 是讯飞推出的桌面级 AI 工作搭子,支持文件整理、数据分析、网页操作及通过飞书/钉钉远程操控电脑,助你高效完成本地办公任务 。

0

2026.09.22

NumPy常见函数使用方法
NumPy常见函数使用方法

本专题整理 NumPy 常见函数使用方法相关教程,覆盖函数大全、参数用法、数组运算、统计聚合、排序处理、where 条件筛选、linspace 创建数列等常用场景,帮助读者快速掌握 NumPy 函数调用思路和实际数据处理技巧。

0

2026.09.22

NumPy性能优化版本更新与常见报错排查
NumPy性能优化版本更新与常见报错排查

本专题整理 NumPy 性能优化、版本更新与常见报错排查相关教程,覆盖向量化计算、广播性能、内存布局、NumPy 2.0 升级、版本兼容冲突、安装导入报错、dtype 溢出、矩阵运算异常和 broadcasting 报错修复,帮助读者系统掌握 NumPy 性能调优与问题定位方法。

20

2026.09.22

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

20

2026.09.21

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程,覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

20

2026.09.21

NumPy矩阵运算与线性代数计算
NumPy矩阵运算与线性代数计算

本专题整理 NumPy 矩阵运算与线性代数计算相关教程,覆盖矩阵乘法、dot 与 @ 运算符、逆矩阵、行列式、特征值与特征向量、SVD、线性方程组、欧氏距离、矩阵分解和大规模矩阵性能优化等内容,帮助读者掌握 np.linalg 与矩阵计算实战。

0

2026.09.21

NumPy广播机制数学运算与统计分析
NumPy广播机制数学运算与统计分析

本专题整理 NumPy 广播机制、数组数学运算与统计分析相关教程,覆盖广播规则、维度对齐、矩阵与数组加减除法、向量化计算、均值方差、分位数、中位数、直方图和 unique 频次统计等场景,帮助读者掌握 ndarray 高效计算与统计处理方法。

0

2026.09.21

NumPy数组创建索引切片与数据选择
NumPy数组创建索引切片与数据选择

本专题整理 NumPy 数组创建、索引、切片与数据选择相关教程,覆盖 np.array、zeros/ones、多维数组形状、基础切片、花式索引、布尔索引、条件筛选、视图与副本等常用场景,帮助读者系统掌握 ndarray 数据构造与高效提取方法。

20

2026.09.21

Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw(AI龙虾助手)的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体,能直接在电脑上读写文件、运行脚本、操作浏览器,自动交付Word、PPT、Excel等成品。

40

2026.09.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Echo框架IP地址文档
Echo框架IP地址文档

共0课时 | 0人学习

Echo框架中文安装文档
Echo框架中文安装文档

共0课时 | 0人学习

Echo框架快速入门指南
Echo框架快速入门指南

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn