Gin 中 c.Request.Context() 不能直接 cancel，因其是只读的 HTTP 上下文，无 cancel 方法，需用 context.WithCancel 或 WithTimeout 派生可取消子上下文；传参时只传 context 和纯数据，禁传 *gin.Context。
为什么 Gin 的 c.Request.Context() 不能直接 cancel？
因为 c.Request.Context() 是由 HTTP server 创建的只读上下文，底层是 http.context 实例，它的 Done() 通道在请求结束或客户端断开时自动关闭，但没有暴露 cancel 函数 —— 你调用 context.WithCancel(c.Request.Context()) 才能得到可取消的子上下文。
常见错误是试图对 c.Request.Context() 调用 cancel（根本不存在），或误以为它能主动终止正在运行的 goroutine；实际它只负责「被动响应」客户端断连，不提供主动控制能力。
- HTTP/1.1 客户端关闭连接 →
c.Request.Context().Done()关闭 → 你的 handler 可感知，但无法反向触发它 - 想提前中止耗时操作（比如数据库查询、RPC 调用）？必须基于它派生新 context，用
WithTimeout或WithCancel - 不要把
c.Request.Context()当成“可取消的根”，它只是信号源，不是控制柄
context.WithTimeout 和 context.WithCancel 在 Gin 中怎么选？
选哪个取决于你是否需要「外部触发取消」：超时是时间驱动的自动取消，WithCancel 是逻辑驱动的手动取消。
例如：一个 API 需要调用下游服务，且必须在 3 秒内返回 —— 用 WithTimeout；但如果用户点击「取消上传」按钮，前端发一个新请求来通知后端停掉当前任务 —— 就得用 WithCancel 配合全局 map 存 cancel 函数。
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
WithTimeout(ctx, 3*time.Second)：适合绝大多数 HTTP handler，简单、确定、无状态 -
WithCancel(parentCtx)：适合长任务管理（如 WebSocket 连接、文件上传监控），但要注意 cancel 函数生命周期 —— 必须 defer 调用，且不能跨 goroutine 传递指针 - 别混用：
WithTimeout内部已封装了 cancel，再套一层WithCancel不仅冗余，还可能因 cancel 顺序错乱导致提前退出
Gin handler 里启动 goroutine，ctx 怎么传才安全？
直接传 c.Request.Context() 或其派生 context 没问题，但绝不能传 *gin.Context（即 c）本身 —— 它不是线程安全的，且生命周期只属于当前 handler goroutine。
典型错误是写 go someFunc(c)，然后在 goroutine 里调用 c.JSON() 或 c.Request.URL，轻则 panic（panic: runtime error: invalid memory address），重则读到脏数据或 nil pointer dereference。
- 正确做法：只传 context + 纯数据（如 ID、参数 struct），所有 I/O 和响应逻辑留在主 goroutine
- 如果异步任务需要写日志或发消息，用独立 logger 或 channel 通信，不要碰
c - 需要复制 context？不需要 ——
context.Context是接口，值传递即可；gin.Context才需c.Copy()（仅当真要并发读写其内部字段时，极少见）
数据库查询没响应 ctx.Done()？检查 driver 是否支持 context
不是所有 Go 数据库驱动都尊重 context —— 旧版 database/sql 驱动（如某些 MySQL 驱动 v1.4 之前）会忽略 ctx 参数，导致超时后 query 仍卡在 TCP 层。
验证方式：用 ctx, cancel := context.WithTimeout(context.Background(), time.Millisecond) 调用 db.QueryContext(ctx, ...)，看是否立即返回 context.DeadlineExceeded 错误。若返回 nil 或阻塞，说明驱动不支持。
- 推荐驱动：
github.com/go-sql-driver/mysqlv1.7+、github.com/lib/pq、github.com/jackc/pgx/v5都完整支持Context - 切勿用
db.Query()替代db.QueryContext()—— 前者完全无视 context - 连接池设置（如
SetMaxOpenConns）不影响 context 行为，但能减少超时后残留连接
Done()」的操作。像纯计算循环（for i := 0; i ）、未封装的 syscall、或第三方库里没接入 context 的阻塞调用，都不会响应 —— 你得自己加 <code>select 或改用支持 context 的封装版本。 
