在 Go 写的 API 服务里，几乎每个请求处理函数都会带上 `context.Context`，很多人也会习惯性地用 `context.WithTimeout` 给下游调用加个超时。但实际排查线上问题时经常遇到一种情况：接口响应已经返回了 504，日志里也打印了 timeout，可 goroutine 数量却一直涨，内存跟着上去，最后服务变得很慢。问题的根子往往不在 `WithTimeout` 本身，而在于超时之后那些还在跑的 goroutine 没有正确退出，尤其是它们阻塞在 channel 发送、锁等待或者没有感知 ctx 的第三方调用上。这篇文章从几个真实的代码片段出发，讲清楚 `context.WithTimeout` 的取消信号是怎么传播的、哪些写法会让取消信号失效，以及怎么用 `errgroup`、带缓冲 channel 和 `defer cancel()` 把这类泄漏堵住。

先看一段很常见的错误写法。假设我们有一个查询用户订单的函数，内部起了一个 goroutine 去调下游 RPC，主 goroutine 等结果或者等超时：

```go
func GetOrders(ctx context.Context, uid int64) ([]Order, error) {
 ctx, cancel := context.WithTimeout(ctx, 200*time.Millisecond)
 defer cancel()

 ch := make(chan []Order) // 无缓冲
 go func() {
 orders, err := rpcClient.QueryOrders(ctx, uid)
 if err != nil {
 return
 }
 ch <- orders // 如果主 goroutine 已经走了，这里永久阻塞
 }()

 select {
 case <-ctx.Done():
 return nil, ctx.Err()
 case orders := <-ch:
 return orders, nil
 }
}
```

这段代码在超时分支返回后，子 goroutine 如果刚好完成 RPC 并执行到 `ch <- orders`，因为没人接收，它会永远卡在那里。goroutine 本身不占太多内存，但它引用的 `orders` 切片、RPC 连接相关的对象都跟着泄漏。修法很简单，把 channel 改成带缓冲的，容量为 1：

```go
ch := make(chan []Order, 1)
```

这样子 goroutine 发送完就能退出，不管主 goroutine 还在不在。这个细节在官方博客里提过，但写业务代码时很容易忘。

另一种更隐蔽的情况是下游调用根本不看 ctx。比如用了某个老版本的数据库驱动或者自己封装的 HTTP 客户端，`QueryOrders` 内部没有把 ctx 透传给底层，那么即使 `context.WithTimeout` 触发了，子 goroutine 还是要等 RPC 自己超时才能返回。这时候 `defer cancel()` 只是释放了 ctx 上的定时器，并不会杀掉 goroutine。排查这类问题可以用 `runtime.NumGoroutine()` 打点，或者直接上 pprof 看 goroutine 的栈：

```go
import _ "net/http/pprof"

// 在排查环境里开一个 debug 端口
go func() {
 http.ListenAndServe("127.0.0.1:6060", nil)
}()
```

然后 `go tool pprof http://127.0.0.1:6060/debug/pprof/goroutine`，看大量 goroutine 卡在哪个函数上。如果栈里全是 `chan send` 或者某个 RPC 的 `Read`，基本就能定位到上面说的两种问题。

再来看一个多 goroutine 聚合的场景，很多接口会并发查多个下游再合并结果。这种代码用 `errgroup` 比手写 `sync.WaitGroup` 加 channel 更稳，因为 `errgroup.WithContext` 会在任意一个任务返回错误时取消其余任务：

```go
func GetUserProfile(ctx context.Context, uid int64) (*Profile, error) {
 ctx, cancel := context.WithTimeout(ctx, 300*time.Millisecond)
 defer cancel()

 g, ctx := errgroup.WithContext(ctx)

 var user *User
 var stats *Stats

 g.Go(func() error {
 u, err := userClient.Get(ctx, uid)
 if err != nil {
 return err
 }
 user = u
 return nil
 })

 g.Go(func() error {
 s, err := statsClient.Get(ctx, uid)
 if err != nil {
 return err
 }
 stats = s
 return nil
 })

 if err := g.Wait(); err != nil {
 return nil, err
 }
 return &Profile{User: user, Stats: stats}, nil
}
```

`errgroup` 能保证 `Wait` 返回时所有 goroutine 都已经退出，前提还是那些 client 方法真的把 ctx 传到了底层。如果某个 client 忽略 ctx，`g.Wait()` 照样会卡住，超时形同虚设。所以给下游 client 写封装时，第一件事就是检查 ctx 有没有被透传，HTTP 请求用 `http.NewRequestWithContext`，数据库用 `QueryContext` / `ExecContext`，gRPC 直接把 ctx 传进去。

还有一个容易忽略的点是 `defer cancel()` 的位置。有人会在函数开头 `ctx, cancel := context.WithTimeout(...)` 之后忘了 defer，只在成功路径上调用 cancel，出错路径直接 return。这样定时器会一直挂到超时时间才释放，虽然不会造成 goroutine 泄漏，但在高 QPS 下会堆积大量 timer，GC 压力明显。Go 1.21 之后 `context.WithTimeout` 内部用 `time.AfterFunc` 实现，未取消的 timer 会一直持有 ctx 引用，所以 `defer cancel()` 应该是无条件的。

最后说一个和 HTTP 服务端相关的细节。`http.Server` 的 `ReadTimeout`、`WriteTimeout` 以及 `BaseContext` 都能给请求生命周期设上限，但 `BaseContext` 返回的 ctx 不会因为客户端断开而取消。如果处理函数里要感知客户端断开，得监听 `r.Context().Done()`，而这个 ctx 在 Go 1.8 之后默认就会在连接关闭时取消。写长轮询或者 SSE 接口时，用 `r.Context()` 而不是自己 new 一个 `context.Background()`，能省掉不少手动清理的代码。

把上面这些串起来，处理超时的核心就一句话：取消信号要能到达每一个阻塞点。channel 要有缓冲或者 select 里监听 ctx，下游 client 要透传 ctx，聚合任务用 `errgroup`，`cancel` 一律 defer。写的时候多看一眼 goroutine 的退出路径，比事后用 pprof 翻栈要省事得多。

 推荐查看成语：https://www.tianqi556.com/chengyu/15301.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15302.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15303.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15304.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15305.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15306.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15307.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15308.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15309.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15310.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15311.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15312.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15313.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15314.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15315.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15316.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15317.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15318.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15319.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15320.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15321.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15322.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15323.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15324.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15325.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15326.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15327.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15328.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15329.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15330.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15331.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15332.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15333.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15334.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15335.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15336.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15337.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15338.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15339.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15340.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15341.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15342.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15343.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15344.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15345.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15346.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15347.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15348.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15349.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15350.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15351.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15352.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15353.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15354.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15355.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15356.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15357.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15358.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15359.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15360.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15361.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15362.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15363.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15364.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15365.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15366.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15367.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15368.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15369.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15370.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15371.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15372.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15373.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15374.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15375.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15376.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15377.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15378.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15379.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15380.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15381.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15382.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15383.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15384.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15385.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15386.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15387.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15388.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15389.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15390.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15391.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15392.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15393.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15394.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15395.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15396.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15397.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15398.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15399.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15400.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15401.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15402.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15403.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15404.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15405.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15406.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15407.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15408.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15409.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15410.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15411.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15412.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15413.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15414.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15415.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15416.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15417.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15418.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15419.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15420.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15421.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15422.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15423.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15424.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15425.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15426.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15427.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15428.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15429.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15430.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15431.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15432.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15433.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15434.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15435.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15436.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15437.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15438.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15439.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15440.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15441.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15442.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15443.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15444.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15445.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15446.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15447.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15448.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15449.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15450.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15451.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15452.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15453.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15454.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15455.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15456.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15457.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15458.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15459.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15460.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15461.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15462.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15463.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15464.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15465.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15466.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15467.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15468.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15469.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15470.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15471.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15472.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15473.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15474.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15475.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15476.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15477.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15478.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15479.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15480.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15481.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15482.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15483.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15484.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15485.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15486.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15487.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15488.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15489.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15490.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15491.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15492.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15493.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15494.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15495.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15496.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15497.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15498.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15499.html
 推荐查看成语：https://www.tianqi556.com/chengyu/15500.html

在 Go 写的 API 服务里，几乎每个请求处理函数都会带上 context.Context，很多人也会习惯性地用 context.WithTimeout 给下游调用加个超时。但实际排查线上问题时经常遇到一种情况：接口响应已经返回了 504，日志里也打印了 timeout，可 goroutine 数量却一直涨，内存跟着上去，最后服务变得很慢。问题的根子往往不在 WithTimeout 本身，而在于超时之后那些还在跑的 goroutine 没有正确退出，尤其是它们阻塞在 channel 发送、锁等待或者没有感知 ctx 的第三方调用上。这篇文章从几个真实的代码片段出发，讲清楚 context.WithTimeout 的取消信号是怎么传播的、哪些写法会让取消信号失效，以及怎么用 errgroup、带缓冲 channel 和 defer cancel() 把这类泄漏堵住。

Go 服务里用 context.WithTimeout 处理 HTTP 请求超时，为什么你的 goroutine 还在泄漏？

在 Go 写的 API 服务里，几乎每个请求处理函数都会带上 context.Context，很多人也会习惯性地用 context.WithTimeout 给下游调用加个超时。但实际排查线上问题时经常遇到一种情况：接口响应已经返回了 504，日志里也打印了 timeout，可 goroutine 数量却一直涨，内存跟着上去，最后服务变得很慢。问题的根子往往不在 WithTimeout 本身，而在于

编程语言

后端

运维

Go接口超时处理中，goroutine泄漏多因取消信号未能触达所有阻塞点。无缓冲channel发送、下游客户端未透传ctx、缺失defer cancel()均会导致资源堆积。需用带缓冲channel、errgroup管理聚合任务，并确保HTTP/DB/gRPC调用感知ctx，彻底解决504与内存增长问题。

代码解释

数据库

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Go 服务里用 context.WithTimeout 处理 HTTP 请求超时，为什么你的 goroutine 还在泄漏？-腾讯云开发者社区-腾讯云

Go 服务里用 context.WithTimeout 处理 HTTP 请求超时，为什么你的 goroutine 还在泄漏？

Go 服务里用 context.WithTimeout 处理 HTTP 请求超时，为什么你的 goroutine 还在泄漏？

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐