如何在 Go 中使用 net/http.TimeoutHandler 包装超时处理-Golang-PHP中文网

timeouthandler 是包装器而非中间件，它通过独立 goroutine 监控超时并中断响应写入，但不终止原 handler 的执行；需手动结合 context.context 控制内部阻塞操作。

如何在 go 中使用 net/http.timeouthandler 包装超时处理

TimeoutHandler 本质是包装器，不是中间件

net/http.TimeoutHandler 的作用是给一个 http.Handler 加上整体请求超时控制，它会启动独立的 goroutine 监控时间，并在超时后中断响应写入。它不修改原 handler 的逻辑，也不参与中间件链式调用——你不能把它和 http.HandlerFunc 直接拼成链式中间件（比如 middleware(next) 那种），它只接受 http.Handler，返回一个新的 http.Handler。

常见错误是试图这样写：

http.Handle("/api", timeoutMiddleware(http.HandlerFunc(myHandler))) // ❌ timeoutMiddleware 不存在

正确做法是直接包装并注册：

确保你的 handler 是 http.Handler 类型（http.HandlerFunc 满足该接口）
传入超时时间（time.Duration），注意单位别写错，比如 30 * time.Second 而不是 30
第三个参数是超时响应体，类型为 string，会被写入 ResponseWriter，且 Content-Length 固定为其字节长度

超时触发后无法再写入响应，但 handler 可能仍在运行

这是最容易被忽略的点：TimeoutHandler 超时后会关闭底层 ResponseWriter 的写通道（内部用 io.ErrClosedPipe 模拟中断），但原 handler 的 goroutine 不会自动被取消或停止。如果你的 handler 里有数据库查询、HTTP 调用或循环处理，它们会继续执行，可能造成资源泄漏或重复副作用。

解决方法只有手动配合 context.Context：

不要依赖 TimeoutHandler 自动终止业务逻辑
在 handler 内部显式接收 context.Context（例如从 r.Context() 获取）
所有阻塞操作（如 db.QueryContext、http.Client.Do）必须传入该 context
TimeoutHandler 本身不会修改 request 的 context，但它会在超时后让 r.Context().Done() 关闭

示例片段：

使用Go语言搭建家庭相册系统-相关课件

下载

handler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    ctx := r.Context()
    select {
    case <h3>超时响应体不支持动态状态码或 Header</h3><p><code>TimeoutHandler</code> 写超时响应时，固定使用 <code>http.StatusServiceUnavailable</code>（503），且不允许设置自定义 Header 或状态码。它调用的是 <code>w.WriteHeader(http.StatusServiceUnavailable)</code> 后直接写入你传入的字符串。</p><p>如果你需要返回 408（Request Timeout）、自定义 JSON 错误、或添加 <code>X-Retry-After</code> 等 header，<code>TimeoutHandler</code> 无能为力。此时必须自己实现超时控制，例如：</p>

用 http.NewServeMux + 自定义 wrapper，包装 ResponseWriter 并拦截 WriteHeader
用 context.WithTimeout 包裹 handler 逻辑，在顶层判断 ctx.Err() == context.DeadlineExceeded，再手动写响应
避免用 TimeoutHandler，改用反向代理类封装（如 httputil.ReverseProxy 自带超时）