最轻量并发限流用 chan struct{},容量即硬性并发上限;rate.Limiter 控制 QPS 而非并发数;errgroup.Group 适合带取消的并发管理;sync.Map 限流需短 key+定时清理。

用 chan struct{} 做信号量是最轻量、最可控的并发限流
它不依赖任何外部包,语义清晰,直接控制「同时运行的 goroutine 数量」,适合 IO 密集型任务或 worker 池场景。缓冲区容量就是硬性并发上限,调度开销极小,阻塞发生在 channel 上,而非业务逻辑里。
- 缓冲大小设为
N,就严格保证最多N个 goroutine 并发执行 - 必须用
defer归还令牌,漏掉会导致永久泄漏 - 别在循环内反复创建新 channel,复用一个即可
- channel 容量建议设为整数(如 10、50、100),避免凭感觉拍出 37 这类难维护的值
rate.Limiter 不是并发控制器,别拿它卡 goroutine 数量
rate.Limiter 控制的是「单位时间请求数」(QPS),不是并发数。它基于令牌桶算法,适合 API 网关、防刷等场景。如果你用它来限制 goroutine 并发,会发现:100 个 goroutine 同时调 Allow(),前 burst 个全过,瞬时并发照样爆表。
-
rate.NewLimiter(rate.Every(200*time.Millisecond), 1)表示 ≈10 QPS,不是“最多 1 个 goroutine 运行” - 它不感知 goroutine 生命周期,只看请求到达时间戳
- 若真要控并发,请用
chan struct{}或errgroup.Group+ context - 误用表现:压测时延迟毛刺大、CPU 占用低但下游被打挂——因为限流没拦住并发,只拦了平均速率
用 errgroup.Group 替代 sync.WaitGroup 实现带取消的并发限流
当需要超时、主动中断或错误传播时,errgroup.Group 比裸写 WaitGroup 更安全。它内置 context 支持,自动等待所有 goroutine 结束,并传播第一个错误。
- 初始化时传入带 timeout 的 context:
eg, _ := errgroup.WithContext(ctx) - 每个任务用
eg.Go(func() error { ... })启动,失败会自动终止其余任务 - 不用手动管理 channel 或 defer 归还,逻辑更紧凑
- 注意:它本身不限流,需配合
chan struct{}使用,比如在Go函数里先取令牌再执行
细粒度限流时,sync.Map key 要够短、要清理、别拼字符串
按 IP 或路径做限流,必须为每个维度分配独立 rate.Limiter 实例。用 map[string]*rate.Limiter 高并发下会 panic;用 sync.Map 是正确选择,但 key 设计和生命周期管理极易出错。
- key 控制在 64 字节内,推荐哈希后取前 16 字节(如
md5.Sum([]byte(ip))[:16]),别直接用完整 IP 或带 query 的 URL - 必须加过期清理:对 5 分钟未访问的 key 调
sync.Map.Delete,否则内存只增不减 - 别每次请求都调
c.ClientIP()+strings.Split()拼 key——这些操作分配堆内存,hot path 上要命 - 提前提取并缓存到
c.Set("limiter_key", key),中间件里直接读



















