go语言singleflight缓存

创建时间: 2025-12-12 17:04:53修改时间: 2025-12-16 22:14:26

前言

最近发现go语言有一个很好用的缓存库singleflight,所以今天就打算研究一下这个库,貌似还是go官方团队弄出来的。就是可以做一个缓存,这个对高并发场景下应该能用得上吧。

实例

直接上案例吧

var sfg singleflight.Group

func main() {
	var wg sync.WaitGroup
	wg.Add(5)

	fmt.Println("无缓存==========================")

	//模拟5个并发 无缓存
	for i := 0; i < 5; i++ {
		go func() {
			defer wg.Done()
			data, err := getDataNoCache("key")
			if err != nil {
				log.Print(err)
				return
			}
			log.Println(data)
		}()
	}
	wg.Wait()

	fmt.Println("有缓存==========================")

	wg.Add(5)
	//模拟5个并发 有缓存
	for i := 0; i < 5; i++ {
		go func() {
			defer wg.Done()
			data, err := getData("key")
			if err != nil {
				log.Print(err)
				return
			}
			log.Println(data)
		}()
	}
	wg.Wait()

	fmt.Println("有缓存==========================")

	wg.Add(5)
	//模拟5个并发 异步
	for i := 0; i < 5; i++ {
		go func() {
			defer wg.Done()
			data, err := getDataAsync("key")
			if err != nil {
				log.Print(err)
				return
			}
			log.Println(data)
		}()
	}
	wg.Wait()
}

// 获取数据 无缓存
func getDataNoCache(key string) (string, error) {
	v, err := getDataFromDB(key)
	if err != nil {
		return "nil", err
	}
	return v, nil
}

// 获取数据 有缓存, 同步的方式
func getData(key string) (string, error) {
	v, err, _ := sfg.Do(key, func() (interface{}, error) {
		return getDataFromDB(key)
	})
	if err != nil {
		log.Println(err)
		return "", err
	}

	return v.(string), err
}

// 获取数据 有缓存, 异步的方式
func getDataAsync(key string) (string, error) {
	ch := sfg.DoChan(key, func() (interface{}, error) {
		return getDataFromDB(key)
	})
	v := <-ch

	if v.Err != nil {
		log.Println(v.Err)
		return "", v.Err
	}

	return v.Val.(string), v.Err
}

// 模拟从数据库中获取值
func getDataFromDB(key string) (string, error) {
	log.Printf("get %s from database", key)
	return "data", nil
}

运行效果如下:

无缓存==========================
2025/12/12 16:52:00 get key from database
2025/12/12 16:52:00 data
2025/12/12 16:52:00 get key from database
2025/12/12 16:52:00 data
2025/12/12 16:52:00 get key from database
2025/12/12 16:52:00 data
2025/12/12 16:52:00 get key from database
2025/12/12 16:52:00 data
2025/12/12 16:52:00 get key from database
2025/12/12 16:52:00 data
有缓存==========================
2025/12/12 16:52:00 get key from database
2025/12/12 16:52:00 data
2025/12/12 16:52:00 data
2025/12/12 16:52:00 data
2025/12/12 16:52:00 data
2025/12/12 16:52:00 data
有缓存==========================
2025/12/12 16:52:00 get key from database
2025/12/12 16:52:00 data
2025/12/12 16:52:00 data
2025/12/12 16:52:00 data
2025/12/12 16:52:00 data
2025/12/12 16:52:00 data

可以看到有缓存的情况下并不是每次都会去调用getDataFromDB,而是在调用第一次后,往后的调用可以直接返回结果。这个包有一个优势,就是我根本不需要处理过期时间什么的,因为他这个缓存时间其实很短的(更新:实际上这个包并不是缓存,而是限流,就是同一时刻调用这个函数,只有一个人能调用这个函数,但是拿到的返回结果是一样的),比如我将代码改成这样“就是让协程不是并发执行的”。

func main() {
	var wg sync.WaitGroup
	wg.Add(5)

	fmt.Println("无缓存==========================")

	//模拟5个并发 无缓存
	for i := 0; i < 5; i++ {
		go func() {
			defer wg.Done()
			data, err := getDataNoCache("key")
			if err != nil {
				log.Print(err)
				return
			}
			log.Println(data)
		}()
	}
	wg.Wait()

	fmt.Println("有缓存==========================")

	wg.Add(5)
	//模拟5个并发 有缓存
	for i := 0; i < 5; i++ {
		time.Sleep(1 * time.Second)
		go func() {
			defer wg.Done()
			data, err := getData("key")
			if err != nil {
				log.Print(err)
				return
			}
			log.Println(data)
		}()
	}
	wg.Wait()

	fmt.Println("有缓存==========================")

	wg.Add(5)
	//模拟5个并发 异步
	for i := 0; i < 5; i++ {
		time.Sleep(1 * time.Second)
		go func() {
			defer wg.Done()
			data, err := getDataAsync("key")
			if err != nil {
				log.Print(err)
				return
			}
			log.Println(data)
		}()
	}
	wg.Wait()
}

结果每次请求值他并不会走缓存。结果如下:

无缓存==========================
2025/12/12 16:56:28 get key from database
2025/12/12 16:56:28 data
2025/12/12 16:56:28 get key from database
2025/12/12 16:56:28 data
2025/12/12 16:56:28 get key from database
2025/12/12 16:56:28 data
2025/12/12 16:56:28 get key from database
2025/12/12 16:56:28 data
2025/12/12 16:56:28 get key from database
2025/12/12 16:56:28 data
有缓存==========================
2025/12/12 16:56:29 get key from database
2025/12/12 16:56:29 data
2025/12/12 16:56:30 get key from database
2025/12/12 16:56:30 data
2025/12/12 16:56:31 get key from database
2025/12/12 16:56:31 data
2025/12/12 16:56:32 get key from database
2025/12/12 16:56:32 data
2025/12/12 16:56:33 get key from database
2025/12/12 16:56:33 data
有缓存==========================
2025/12/12 16:56:34 get key from database
2025/12/12 16:56:34 data
2025/12/12 16:56:35 get key from database
2025/12/12 16:56:35 data
2025/12/12 16:56:36 get key from database
2025/12/12 16:56:36 data
2025/12/12 16:56:37 get key from database
2025/12/12 16:56:37 data
2025/12/12 16:56:38 get key from database
2025/12/12 16:56:38 data