如何在 Go 中使用 x/sync/errgroup.SetLimit 限制并发数

落明同学_8362

落明同学_8362

2026-05-27

227人浏览

原创

errgroup.Group 本身不提供并发数限制,SetLimit 方法并不存在;正确做法是用 golang.org/x/sync/semaphore.Weighted 配合 errgroup.Go 实现限流,先 Acquire 再执行任务,完成后 Release。

如何在 go 中使用 x/sync/errgroup.setlimit 限制并发数

errgroup.SetLimit 并不存在 —— Go 官方 x/sync/errgroup 包里根本没有这个方法。你查文档、补全、IDE 提示看到的 SetLimit,大概率是误把 errgroup.Group 和第三方库(比如 golang.org/x/sync/errgroup 的 fork 或 github.com/uber-go/goleak 相关工具)混淆了,或者参考了过时的博客/示例。

为什么 errgroup.Group 没有 SetLimit 方法

官方 errgroup.Group 的设计目标是“传播错误 + 等待所有 goroutine 结束”,它本身不负责并发控制。并发数限制属于调度逻辑,应由调用方显式管理。

  • 源码可见:errgroup.Group 只有两个导出字段:ctx 和未导出的 cancel;唯一导出方法是 Go、Wait、TryGo
  • TryGo 是唯一带“节流”语义的方法:它在 ctx 已取消时跳过启动 goroutine,但不阻塞、也不限并发数
  • 如果你需要限速,必须自己套一层信号量(如 semaphore.Weighted)或 channel 控制

正确做法:用 semaphore.Weighted 配合 errgroup.Go

标准库 golang.org/x/sync/semaphore 提供了轻量级、无锁的信号量实现,和 errgroup.Group 组合使用最自然。

关键点:

  • 先创建一个 *semaphore.Weighted,容量即最大并发数(如 5)
  • 每个任务在 errgroup.Go 启动前,先 Acquire(ctx, 1);完成后 Release(1)
  • 务必检查 Acquire 返回的 error(比如 ctx 被 cancel),否则可能 panic 或漏执行
import (
    "context"
    "golang.org/x/sync/errgroup"
    "golang.org/x/sync/semaphore"
)
<p>func doWork(ctx context.Context, urls []string) error {
g, ctx := errgroup.WithContext(ctx)
sem := semaphore.NewWeighted(5) // 最大并发 5</p><pre class="brush:php;toolbar:false;">for _, url := range urls {
    url := url // 避免循环变量捕获
    g.Go(func() error {
        if err := sem.Acquire(ctx, 1); err != nil {
            return err // ctx canceled 或其他中断
        }
        defer sem.Release(1)

        return fetchAndProcess(url) // 你的实际工作
    })
}

return g.Wait()

}

Golang Uber Dig
Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等

下载

常见踩坑点:channel 控制 vs semaphore.Weighted

有人用 make(chan struct{}, N) 做并发控制,看似简单,但容易出错:

  • 忘记 defer close(ch)?不会直接 crash,但会泄漏 goroutine 等待
  • 在 errgroup.Go 内部直接 ch + <code>?如果某个任务 panic,<code> 永远不执行,信号量卡死,后续所有任务 hang 住
  • semaphore.Weighted 是原子操作 + context-aware,Acquire 可被 cancel,Release 可重入,更健壮
  • 性能上:channel 控制有额外 goroutine 调度开销;semaphore.Weighted 是纯内存 CAS 操作,更轻量

替代方案:用 errgroup.WithContext + time.Sleep 做粗粒度限速

如果只是想“每秒最多跑 N 个”,而不是严格限制并发数(比如防 API 限流),可以用 time.Ticker 控制节奏,配合 errgroup.Go 启动:

  • 启动一个 goroutine 持续发送 ticker 信号到 channel
  • 主循环中每次从 ticker channel 收一个信号再启动一个任务
  • 注意:这不等于并发控制 —— 所有任务仍会并发执行,只是启动节奏被压慢
  • 适合场景:避免瞬间打爆下游,但任务本身耗时不长、且不要求严格并发上限

真正要控住“同时运行的 goroutine 数量”,semaphore.Weighted 是目前最直接、最安全的选择。别在 errgroup 上找不存在的 SetLimit,它从来就没打算管这事。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

golang go语言

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

3209

3

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2023.07.25

2328

9

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

2023.08.02

1260

5

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.09

1218

4

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

2023.09.05

1356

5

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2023.09.20

2198

7

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

2023.09.20

3500

8

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

2023.09.22

16035

6

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

549

3

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程