Go的singleflight

Tue, 14 Jul 2026 00:00:00 +0000

作用

golang.org/x/sync/singleflight 用于合并同一个 key 的并发请求：当多个 goroutine 并发调用同一个 key 的函数时，只有第一个真正执行，其余等待共享结果。

核心 API

// Group 代表一个 singleflight 分组，不同 key 的请求隔离
var g singleflight.Group

// Do：同步调用，key 相同时只执行一次 fn，返回共享结果
val, err, shared := g.Do("key", func() (any, error) {
 return fetchFromDB(), nil
})
// shared 为 true 表示结果被其他调用者共享

// DoChan：异步版本，返回 channel
ch := g.DoChan("key", func() (any, error) {
 return fetchFromDB(), nil
})
result := <-ch

// Forget：删除 key 对应的已缓存结果，下次 Do 会重新执行 fn
g.Forget("key")

典型场景：防止缓存击穿

var g singleflight.Group

func GetArticle(ctx context.Context, id int64) (*Article, error) {
 // 先查 Redis 缓存
 cacheKey := fmt.Sprintf("article:%d", id)
 val, err := redis.Get(ctx, cacheKey)
 if err == nil {
 return parseArticle(val), nil
 }

 // 缓存未命中，用 singleflight 合并去数据库的请求
 // 同一篇文章 1000 个并发请求只会触发 1 次 DB 查询
 v, err, _ := g.Do(cacheKey, func() (any, error) {
 // 可能第一个请求查了 Redis 也没有，所以这里再次 double-check
 // 也可以省略，取决于是否需要
 article, err := db.QueryArticle(ctx, id)
 if err != nil {
 return nil, err
 }
 // 写入缓存
 redis.Set(ctx, cacheKey, serialize(article), 10*time.Minute)
 return article, nil
 })
 if err != nil {
 return nil, err
 }
 return v.(*Article), nil
}

vs 加锁排队

防止缓存击穿的另一种常见方案是加锁排队——缓存未命中时抢锁，抢到的负责查库回种，没抢到的等锁释放后重试读缓存：

Singleflight on giftiaのblog

Go的singleflight

作用

核心 API

典型场景：防止缓存击穿

vs 加锁排队