context canceled 是正常信号而非 bug，需先确认是否由客户端断开、超时或显式 cancel 触发；http handler 应立即检查上下文状态，所有阻塞操作前须传入 context 并处理取消错误。
Context Canceled 是正常信号，不是 bug
遇到 context.Canceled 错误，第一反应不该是“修复”，而是确认：这个取消是不是你或上游主动触发的？比如 HTTP 请求被客户端断开、超时结束、或调用方显式调用 cancel()。Go 的 context 就是靠这个错误来优雅退出的，强行捕获后忽略或重试反而破坏语义。
常见错误现象：Get "https://api.example.com": context canceled 突然大量出现，日志里没对应 cancel 调用 —— 很可能客户端（浏览器、curl、前端 SDK）已关连接，但你的 handler 还在读 body 或发下游请求。
- HTTP handler 中，
r.Context()一进来就可能已取消，别等走到 DB 查询才检查 - 所有阻塞操作（
http.Do、db.QueryRow、time.Sleep）前必须传入 context，并检查返回 err 是否为context.Canceled或context.DeadlineExceeded - 自定义函数接收
ctx context.Context参数时，不要只在开头select { case —— 中间长时间计算也要定期轮询 <code>ctx.Err()
http.Client 默认不继承父 Context 的 deadline
很多人以为把 context 传给 http.NewRequestWithContext 就万事大吉，其实 http.Client 自己的 Timeout、Transport 设置会覆盖它。结果是：context 取消了，但底层 TCP 连接还在等响应，goroutine 卡住。
正确做法是让 http.Client 和 context 协同工作：
- 创建 client 时设
Timeout: 0（禁用 client 自身超时），完全依赖 context 控制生命周期 - 用
http.NewRequestWithContext(ctx, ...)，确保 request 携带 context - 注意：如果用了自定义
http.Transport，要确认其IdleConnTimeout和TLSHandshakeTimeout不会干扰 context 取消逻辑
示例关键行：req, _ := http.NewRequestWithContext(ctx, "GET", url, nil)，然后 client.Do(req) —— 此时若 ctx 被 cancel，Do 会立即返回 context.Canceled 错误。
子 goroutine 必须显式传递并监听 Context
启动新 goroutine 时，如果直接用外层变量或闭包捕获 context，极易漏掉取消传播。典型反模式：go func() { doWork() }() —— 这个 goroutine 根本不知道父 context 已取消。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
必须做三件事：
- 把 context 作为参数显式传入 goroutine 函数
- 在 goroutine 内部用
select监听ctx.Done()，并在退出前清理资源（如关闭 channel、释放锁、取消子请求） - 避免用
context.Background()或context.TODO()替代传入的 ctx —— 它们无法被取消
错误示例：go processItem(item)（processItem 内部没 ctx 参数）；正确写法：go processItem(ctx, item)，且函数签名是 func processItem(ctx context.Context, item string)。
log 打印 Context Canceled 要加判断，否则污染日志
直接把所有 error 都 log.Printf("err: %v", err)，会导致每秒几百条 context canceled 刷屏，掩盖真正异常。这不是错误率高，是流量大 + 用户频繁刷新/关闭页面的正常表现。
处理建议：
- 在 error 处理分支中，先用
errors.Is(err, context.Canceled)或errors.Is(err, context.DeadlineExceeded)判断 - 如果是这两种，用
log.Debug或直接跳过，不记 ERROR 级别日志 - 注意：不要用
err == context.Canceled，要用errors.Is—— 因为实际返回的可能是包装后的 error（如net/http返回的是*url.Error）
容易被忽略的点：中间件、defer 清理函数里也可能拿到 context.Canceled，那里打日志更要谨慎 —— 一次请求可能触发多次 cancel 日志。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
