Golang 从入门到放弃 -0x14

如果你刚开始看 Go 项目代码，十有八九会经常看到一个参数排在最前面：ctx context.Context。很多新手第一次看会觉得它很玄学，仿佛大家都在传一个神秘令牌。但其实它很朴素，核心就几件事：取消、超时、截止时间、少量请求级数据。

为什么需要 context

假设一个 HTTP 请求进来，后面又查数据库，又调第三方接口。如果用户半路断开了，或者这个请求已经超时了，你总不希望后面的 goroutine 还在闷头干活。

context 的意义，就是把“这个请求已经不值得继续了”这件事，一路传下去。

最常见的：超时

ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
defer cancel()

select {
case <-time.After(3 * time.Second):
    fmt.Println("done")
case <-ctx.Done():
    fmt.Println("timeout:", ctx.Err())
}

这里时间到了以后，ctx.Done() 那个 channel 会收到信号。你只要在合适的位置监听它，就能及时收手。

WithCancel 也很常见

有时候不是时间到了，而是上层逻辑决定“不干了”。这时候可以自己手动取消。

ctx, cancel := context.WithCancel(context.Background())

go func() {
    time.Sleep(time.Second)
    cancel()
}()

<-ctx.Done()
fmt.Println("cancelled:", ctx.Err())

HTTP 请求里天然就有 ctx

在 HTTP handler 里你不用自己从零造，直接拿请求上的就行。

func userHandler(w http.ResponseWriter, r *http.Request) {
    ctx := r.Context()
    _ = ctx
}

这个 ctx 一路往下传给 service、repository、数据库调用，是非常常见的姿势。

函数签名的习惯

如果一个函数要接收 context，通常把它放在第一个参数。

func (s *UserService) GetUser(ctx context.Context, id int) (*User, error) {
    // ...
}

这已经算 Go 里的约定俗成了，别故意跟大家对着来。

WithValue 能用，但别滥用

context 确实支持挂值，但它更适合少量、请求级、跨层都可能用到的信息，比如 request id、trace id、登录态这类东西。

别把一堆业务参数都塞进 context 里，不然函数签名虽然变短了，可读性会一路滑坡。

不要把 context 存进 struct

这是一个很常见的坏味道。context 的生命周期通常跟一次请求、一次任务有关，而不是跟某个长期存活的对象绑定。该传参就传参，别图省事放成字段。

小结

这一章主要是把 context 去神秘化：

• 它主要解决取消、超时和请求级传递。
• 有 ctx 的函数，通常把它放第一个参数。
• HTTP 请求的 r.Context() 很重要。
• WithValue 能用，但别把它当万能口袋。

下一章我们继续回到 Web 服务，把中间件、路由组织和分层结构一起捋一遍。