直接close(chan)不等于优雅关闭,因为仅使后续接收返回零值,无法终止正在运行的worker协程;必须配合done信号、select监听与wg等待三者协同,否则导致任务丢失或协程卡死。

Go 里没有“启动队列”这回事——chan 本身是同步/异步通信载体,所谓“高并发队列”实际是用 chan 搭配 worker 池(goroutine + select)实现的任务分发模型。它的“启动”只是启动一批监听 channel 的 goroutine,“关闭”则必须协调信号、通知、等待三者,否则必然丢任务或卡死。
为什么直接 close(chan) 不等于优雅关闭
关闭一个 chan 只会让后续的接收操作立即返回零值(或阻塞解除),但对正在运行的 goroutine 完全无影响。常见错误是:
- 主 goroutine
close(done)后就wg.Wait(),但 worker 里没监听done或没在case 分支里return - worker 在
default分支里持续干活,完全无视done或ctx.Done() - 多个 worker 共享一个
chan Task,但关闭它后仍有 goroutine 尝试从已关 channel 接收,触发 panic: “recv on closed channel”
用 context.WithCancel + WaitGroup 控制 worker 生命周期
这是目前最通用、可组合、易测试的方式,尤其适合带超时、父子链路、HTTP handler 等场景。
- 创建可取消上下文:
ctx, cancel := context.WithCancel(context.Background()) - 每个 worker 启动时传入
ctx,并在循环内用select监听:case - 用
sync.WaitGroup记录活跃 worker 数:启动前wg.Add(1),退出前defer wg.Done() - 主 goroutine 收到信号后调用
cancel(),再wg.Wait();建议加select { case 防卡死
如何安全关闭带缓冲任务 channel
任务 channel(如 tasks chan Task)不能随便 close,否则可能漏掉未消费完的任务或引发 panic。正确做法是:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
- 不主动 close
tasks,让它由 GC 回收;worker 退出靠监听ctx.Done()或done chan struct{} - 如果必须关闭(比如外部要停止投递新任务),先确保所有 worker 已退出,再 close;或改用
select+default非阻塞接收,配合len(tasks) == 0判断是否空闲 - 投递任务时用
select包裹,防 channel 已满阻塞:select { case tasks
HTTP server 和 worker pool 要分开 shutdown
很多人把 HTTP server 和后台 worker 塞进同一套 shutdown 流程,结果 server 已停,worker 还在往数据库写数据。正确解耦方式:
- HTTP server 用
http.Server.Shutdown(),它会拒绝新连接、等待活跃请求完成(需设置ReadTimeout/WriteTimeout) - worker pool 单独用一套
ctx+WaitGroup管理,shutdown 时先server.Shutdown(),再cancelWorkerCtx(),最后wg.Wait() - 注意:不要在
http.HandlerFunc里直接起长期 worker,应通过 channel 投递,由独立 worker 池消费
真正难的不是写几行 cancel() 或 close(),而是判断哪些资源必须等、哪些可以放弃、哪些清理动作本身可能阻塞——比如 db.Close() 在连接卡住时会 hang,得包一层带超时的 context.WithTimeout。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










