推荐使用 sync.Semaphore(Go 1.21+),需传 int64 初始化、Acquire 检查错误、Release 必 defer 配对且全局单例;旧版本用 golang.org/x/sync/semaphore;手写 channel 信号量轻量但易泄漏。

用 sync.Semaphore 控制并发(Go 1.21+ 推荐)
直接用 sync.Semaphore 是目前最稳妥的选择,它专为并发数限制设计,支持上下文取消、panic 安全释放,且无需引入外部依赖。
- 初始化必须传
int64:如sem := semaphore.NewWeighted(int64(5)),传 0 或负数会 panic -
Acquire必须检查错误:if err := sem.Acquire(ctx, 1); err != nil,常见错误是context.DeadlineExceeded或context.Canceled -
Release必须配对且在 goroutine 内部defer:如defer sem.Release(1),否则令牌永久泄漏 - 别在 handler 内重复
new Semaphore——它应是全局单例,生命周期与服务一致
用 golang.org/x/sync/semaphore 兼容旧版本(Go ≤ 1.20)
Go 1.20 及更早版本没有 sync.Semaphore,此时应使用官方维护的 golang.org/x/sync/semaphore,行为和接口几乎一致。
- 执行
go get golang.org/x/sync/semaphore安装 - 初始化:
sem := semaphore.NewWeighted(5)(建议显式写int64(5),避免类型隐式转换歧义) -
Acquire和Release的调用逻辑与标准库完全相同,同样必须defer Release - 若需快速失败(不等、不阻塞),可用
sem.TryAcquire(1),返回bool,适合限流后直接返回 HTTP 429 场景
用 make(chan struct{}, N) 手写信号量(轻量但高风险)
所有 Go 版本都支持,零依赖,但极易出错。它本质是把 channel 当作“许可证池”,容量即最大并发数。
- 初始化:
sem := make(chan struct{}, 3)表示最多 3 个任务并发 - 获取许可:
sem (阻塞直到有空位),不能用select+default替代,否则跳过限流 - 释放许可:
,必须放在 goroutine 内部defer func() { ,闭包变量如i要显式传参 - 别用
len(sem)判断是否可进——它返回已占用数;真正可用的是cap(sem) - len(sem),但一般没必要查 - 绝对不要
close(sem),后续读写都会 panic;也不要用chan int或chan bool,纯属浪费内存和混淆语义
容易被忽略的关键点
并发控制不是“设个数字就完事”。真正卡住系统的,往往是那些没被 recover 的 panic、漏掉的 defer、或误把 runtime.GOMAXPROCS 当成并发上限。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
worker 函数必须兜底 recover(),否则一个未捕获的 panic 会让该 goroutine 永久退出,导致信号量“漏气”、任务堆积、runtime.NumGoroutine() 看似正常但业务已卡死。
缓冲大小设太小(如 1)等于串行,设太大(如 1000)等于没限——实际值要结合下游承受力、本地 fd/内存资源、HTTP/2 连接复用能力综合判断,通常 5–20 是较安全的起点。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










