跨包传递context必须显式作为首参数，禁止隐藏；withvalue需用私有key类型防冲突；withtimeout等应在发起方创建；测试须模拟取消而非用background。
Context 必须显式作为第一个参数传入函数
跨包传递 Context 的核心规则不是“怎么传”，而是“不能不传”——它不能藏在结构体里、不能用全局变量存、也不能靠闭包捕获。只要函数逻辑依赖请求生命周期（比如要响应取消、要读取超时、要取用户 ID），就必须把 ctx context.Context 放在参数列表最前面。
常见错误现象：
- 定义了一个
type Service struct { db *sql.DB }，然后在方法里直接用db.QueryRow(...)，完全没传ctx→ 一旦上层要求超时或取消，这个查询就无法中断 - 在中间件里调用下游包的
DoSomething()，但该函数签名是func DoSomething(arg string) error→ Context 断在包边界，下游无法感知请求已取消
正确做法：
- 下游包的导出函数签名必须是
func DoSomething(ctx context.Context, arg string) error - 上游调用时，直接把收到的
ctx原样传进去，不加包装、不换名、不省略 - 如果下游包已有旧函数且无法改签名，只能封装一层适配器，例如
DoSomethingWithContext(ctx context.Context, arg string) error
WithValue 跨包传递元数据要小心 key 类型
context.WithValue 确实能跨包带数据，但 key 不是字符串，否则极易冲突。不同包都用 "user_id" 当 key，值会互相覆盖，且静态分析工具无法检查。
安全做法：
- 每个包定义自己的私有 key 类型，比如
type userIDKey struct{}，再用context.WithValue(ctx, userIDKey{}, 123) - 导出一个类型安全的 getter 函数，比如
func UserIDFromCtx(ctx context.Context) (int64, bool)，内部用ctx.Value(userIDKey{})取值并断言 - 绝不把
string或int这类基础类型当 key 传给WithValue
性能影响：每次 Value() 都要从当前 Context 往上遍历整个链，key 类型越具体、越少嵌套，查找越快；频繁读写大对象会增加 GC 压力。
WithCancel/WithTimeout 要在发起方创建，不能由下游包代劳
跨包时，谁发起操作，谁负责控制生命周期。下游包不应自己调用 context.WithTimeout —— 它不知道上游还剩多少时间，也不知道是否已被取消。
典型反例：
- HTTP handler 里调用
service.GetUser(ctx)，而GetUser内部又做了ctx, _ = context.WithTimeout(ctx, 3*time.Second)→ 实际超时变成 min(上游剩余时间, 3s)，且 cancel 函数被丢弃，无法主动终止
正确分工：
- HTTP 层或 CLI 入口决定总 deadline，调用
context.WithTimeout(parentCtx, 5*time.Second) - 中间件可基于该 ctx 衍生子 ctx（如加 traceID），但不重设 deadline
- 数据库、RPC 等底层包只接收 ctx，用
ctx.Done()监听取消，用ctx.Err()判断原因，不做任何 WithXXX 操作
测试时别用 context.Background() 模拟真实取消流
单元测试里直接用 context.Background() 调用跨包函数，等于放弃了对取消路径的验证。你测不出 select { case 分支是否真能及时退出。
实操建议：
- 测试需要取消的场景，用
ctx, cancel := context.WithCancel(context.Background())，然后在 goroutine 启动后立即cancel() - 测试超时场景，用
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Millisecond)，并确保后续操作确实耗时更长 - 避免在 test 文件里定义全局
var testCtx = context.Background()—— 它会让所有测试共享同一个无取消能力的 ctx
真正难的不是语法，是每个包的作者都要守住边界：不把 Context 当可选参数，不替上游做生命周期决策，也不用裸类型当 key。跨包协作的健壮性，全系于这一条隐性契约。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
