必须使用只读副本，因为gin.Context在handler返回后立即失效，子goroutine中直接使用原始上下文会导致脏数据、panic或上下文竞态；且recover无法捕获子goroutine中的panic。
直接用 Gin 默认的 handler 启动 goroutine 不等于用了协程池，反而容易引发上下文失效、panic 泄露、资源失控等问题。真正提升响应效率的关键，是把「任务分发」和「执行控制」从 HTTP 请求生命周期里剥离开——用独立、可控、带背压的协程池来承接耗时操作，而不是在每个请求里无序 spawn。
为什么 Gin handler 里直接 go func() 不是协程池
这是最常被误解的一点：写个 go doSomething() 只是启了个 goroutine，不是协程池。它没有数量限制、没有队列缓冲、不跟踪执行状态、无法优雅关闭，更不会拒绝过载任务。
- goroutine 数量随 QPS 线性增长，1000 QPS 就可能拉起 1000+ 协程，调度开销陡增
-
*gin.Context在 handler 返回后立即失效，子 goroutine 里继续用原始c会读到脏数据或 panic（必须用c.Copy()） - 没做 recover，一个任务 panic 会杀掉整个 goroutine，且无日志、不可监控
- HTTP handler 已返回，但后台任务还在跑，连接已断、客户端收不到结果，形成“幽灵任务”
用 ants 池提交任务时要注意 context 透传
ants 的 Submit 接口只接受 func()，但真实业务中几乎都需要超时控制和取消信号，比如 HTTP 调用、DB 查询、文件读写。硬塞一个无 context 的函数进去，等于放弃可观测性和可靠性。
- 不要在 Submit 前统一套
context.WithTimeout(ctx, 5*time.Second)—— 所有任务共享同一个 deadline，不合理 - 正确做法：任务创建时按需构造自己的
context.Context，再封装进闭包，例如：ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second) defer cancel() pool.Submit(func() { // 在这里用 ctx 做 HTTP client.Do 或 db.QueryContext }) - 若用自研池，
Task类型应定义为func(context.Context) error，worker 内部必须select监听ctx.Done()
任务 channel 缓冲大小设多少才不丢任务也不积压
用 chan Task 实现池时，缓冲大小不是拍脑袋定的。它直接决定你能否扛住突发流量，以及内存是否被长期占用。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 缓冲太小（如
make(chan Task, 1)）：等同于同步调用，Submit 会阻塞，拖垮 Gin handler - 缓冲太大（如
make(chan Task, 10000)）：任务堆积在内存里，GC 回收延迟，且掩盖了 worker 吞吐不足的真实问题 - 合理值 ≈ 预估峰值积压量 × 1.5。例如：每秒最多涌进 200 个任务，平均处理耗时 50ms → 理论并发约 10 个，积压峰值可能达 300，缓冲设 450 更稳
- 生产环境务必加
select { case p.tasks ，避免调用方无限等待
关闭池时 wait 和 close 的顺序不能错
close(p.tasks) 只是告诉 worker “不再收新任务”，不代表所有已入队任务都执行完了。如果这时就返回，调用方会误以为“已清空”，而最后几个任务可能刚被取出、正卡在 DB 查询里。
- 必须先停生产者（close tasks chan），再
wg.Wait()等所有 worker 真正退出 -
wg.Add(1)要在go worker()之前调用，否则 race - worker 函数里必须
defer wg.Done()，且要放在for task := range p.tasks循环外层，确保即使 panic 也能 Done - 别在
Shutdown()里 close 后立刻 return —— 要等wg.Wait()完成才算真正关闭
协程池真正的复杂点不在启动，而在边界控制：任务何时该拒、context 怎么传、channel 缓冲怎么调、关闭时怎么确保“一个不落”。这些细节漏掉任何一环，池就退化成隐患放大器，而不是性能加速器。
