结构体缓存 context.Context 是高危操作,因破坏其请求级一次性语义,导致 goroutine 泄漏、取消失效和 Value 链断裂;正确做法是显式传参、每次调用派生新 ctx。

为什么结构体里存 context.Context 是高危操作
结构体字段缓存 context.Context 会直接破坏 Context 的生命周期语义:它本该是请求级、一次性的控制流信号载体,不是状态容器。一旦 struct 持有旧 ctx,就可能出现三种典型故障:goroutine 泄漏(子 ctx 被父 ctx 取消后仍被 struct 强引用)、取消信号失效(下游调用仍用 struct 里的过期 ctx,ctx.Done() 永不关闭)、context.Value 链断裂(新注入的值无法被 struct 内部逻辑读到)。
struct 字段声明 context.Context 的常见误用场景
以下写法看似方便,实则埋雷:
-
type UserService struct { db *sql.DB; ctx context.Context }——ctx在 struct 初始化时传入,后续所有方法都复用它,但实际每个 HTTP 请求应带独立ctx(含不同超时、traceID) -
func (u *UserService) Save(ctx context.Context, user User) error { u.ctx = ctx; return u.saveToDB() }—— 临时覆盖字段,但并发调用会相互污染 -
type Handler struct { svc *UserService }+svc内含ctx—— 中间件注入新ctx(如加userID)后,Handler完全感知不到
正确替代方案:显式传参 + 派生使用
所有需要 ctx 的函数必须把 ctx context.Context 作为第一个参数,且每次调用下游时派生新 ctx:
- HTTP handler 中不要在 struct 里存
ctx,而是从r.Context()拿,再传给业务层:svc.GetUser(ctx, id) - 若需带超时,用
ctx, cancel := context.WithTimeout(ctx, 3*time.Second),并在函数末尾defer cancel() - 若需注入元数据,用
ctx = context.WithValue(ctx, userIDKey{}, userID),并确保 key 是未导出类型(如type userIDKey struct{}) - 启动新
goroutine时,必须显式传入派生的ctx,不能复用 struct 字段里的老ctx
容易被忽略的边界点
真正难防的是那些“看起来合理”的间接持有:比如某个工具类 Logger 结构体接收 ctx 初始化,内部缓存了 traceID;但若这个 Logger 实例被多个请求复用,或跨 goroutine 共享,traceID 就会错乱。更稳妥的做法是让 Logger 不持 ctx,而是在每条日志方法上要求传 ctx(l.Info(ctx, "msg")),或只接受已提取好的 traceID string 参数——Context 的传递边界,必须清晰落在函数签名上,不能滑进结构体字段里。

















