Go语言HTTP超时需分阶段配置：Client端设Timeout（总耗时）、DialContext.Timeout（TCP连接）、TLSHandshakeTimeout（TLS握手）；Server端配Read/Write/Idle/ReadHeaderTimeout；优先用context.WithTimeout实现动态控制，避免误配导致卡死或中断。
Go 语言中 HTTP 超时控制主要通过 http.Client 和 http.Server 的超时字段实现，关键不是“加个 timeout 就完事”，而是要分清不同阶段的超时含义，避免误配导致连接卡死或请求被意外中断。
Client 端：明确区分三类超时
使用自定义 http.Client 时，应设置以下三个核心超时参数（均基于 time.Duration）：
-
Timeout：整个请求的总生命周期上限（从
Do()开始到响应体读完或出错）。它覆盖了下面两项，一旦触发会直接取消请求（含底层连接）。适合兜底控制，建议设为略大于预期最大耗时（如 30s）。 - Transport.DialContext.Timeout：建立 TCP 连接的最长时间（不含 TLS 握手）。默认无限制，生产环境建议显式设为 5–10s，防止 DNS 慢或目标不可达时长期阻塞。
- Transport.TLSHandshakeTimeout：TLS 握手阶段的最大耗时。若服务启用了 HTTPS 且网络不稳定，不设此值可能导致握手卡住。常见设为 10s。
示例配置：
client := &http.Client{Timeout: 30 * time.Second,
Transport: &http.Transport{
DialContext: (&net.Dialer{
Timeout: 5 * time.Second,
KeepAlive: 30 * time.Second,
}).DialContext,
TLSHandshakeTimeout: 10 * time.Second,
},
}
Server 端：监听、读、写、空闲都要管
HTTP 服务器超时需在 http.Server 实例中分别配置，缺一不可：
立即学习“go语言免费学习笔记（深入）”；
- ReadTimeout：从连接建立完成开始，到读完全部请求头和请求体的最长时间。防恶意慢请求（如缓慢发送 body）。
- WriteTimeout：从收到完整请求后，到写完全部响应的最长时间。防 handler 处理过久或响应体生成卡顿。
-
IdleTimeout：TCP 连接空闲（无读写）状态持续多久后关闭。替代已废弃的
KeepAliveTimeout，推荐设为 60–90s，兼顾复用与资源释放。 -
ReadHeaderTimeout：仅限制读取请求头的时间（不含 body），比
ReadTimeout更细粒度，可单独设为 2–5s，快速拦截畸形请求。
示例启动：
srv := &http.Server{Addr: ":8080",
Handler: myHandler,
ReadTimeout: 5 * time.Second,
ReadHeaderTimeout: 2 * time.Second,
WriteTimeout: 10 * time.Second,
IdleTimeout: 60 * time.Second,
}
log.Fatal(srv.ListenAndServe())
进阶技巧：Context 控制更灵活的超时
当需要对单个请求做动态超时（比如根据 URL 或参数调整），或需在超时后执行清理逻辑，优先用 context.WithTimeout()：
- 传入
http.Request.WithContext(ctx)，再交给Client.Do()； - 超时触发时，context 自动取消，底层连接会被中断（如果尚未完成）；
- 注意：Context 超时和 Client.Timeout 是叠加关系，建议只选其一，避免嵌套混乱；
- 若 handler 中发起下游调用，也应把父 context 传下去，保持超时链路一致。
常见误区提醒
- 只设
Client.Timeout却忽略DialContext.Timeout：DNS 解析失败时仍会卡满 Timeout 时间； - Server 端只设
WriteTimeout不设ReadTimeout：攻击者可通过极慢发包让连接长期占用； - 用
time.AfterFunc手动 cancel request：不安全，无法保证 goroutine 及时退出，应统一走 context； - 在 handler 中用
time.Sleep模拟耗时但没设 WriteTimeout：会导致连接堆积，最终 server 拒绝新请求。
基本上就这些。超时不是越短越好，也不是越长越稳，关键是按阶段拆解、按场景设值，并配合监控观察实际耗时分布。
