context.withtimeout是唯一能真正中断外部api调用的机制，因其可穿透dns解析、tcp建连、tls握手等底层阻塞阶段；http.client.timeout仅在req.withcontext(ctx)被调用时才生效，否则对建连和握手无感。
Fiber 框架里调外部 API，光设 client.Timeout 不管用，必须把 context.WithTimeout 传进请求里，否则 DNS 卡住、TLS 握手 hang 死时，超时完全不触发。
为什么 http.Client.Timeout 在 Fiber 里经常失效
很多人在 Fiber 的 handler 里写：
client := &http.Client{Timeout: 5 * time.Second}
resp, err := client.Get("https://api.example.com")
结果日志里全是 net/http: request canceled，或者等了 20 秒才返回——说明超时根本没起作用。根本原因有三个：
-
client.Timeout只在req.WithContext(ctx)被调用时才生效；你直接client.Get()，底层没传任何ctx，它就退化成“只限制读响应体时间”，对 DNS、TCP 建连、TLS 握手完全无感 - Fiber 的
ctx.Context()是独立生命周期的，不会自动注入到http.Client调用链中；你得手动拿、手动塞 - 如果用了封装 SDK（比如云厂商 Go SDK），它们内部可能忽略你传的
ctx，得翻源码确认是否透传
正确做法：用 http.NewRequestWithContext + 显式 Transport 配置
必须从 Fiber 的 ctx.Context() 派生子 context，并完整传递到底层 HTTP 请求。示例代码：
func callExternalAPI(c fiber.Ctx) error {
// 从 Fiber ctx 拿原生 context，并加 8 秒超时
ctx, cancel := context.WithTimeout(c.Context(), 8*time.Second)
defer cancel()
<pre class="brush:php;toolbar:false;">req, err := http.NewRequestWithContext(ctx, "GET", "https://api.example.com/data", nil)
if err != nil {
return c.Status(500).SendString("req build failed")
}
client := &http.Client{
Transport: &http.Transport{
DialContext: (&net.Dialer{
Timeout: 3 * time.Second,
KeepAlive: 30 * time.Second,
}).DialContext,
ResponseHeaderTimeout: 5 * time.Second,
TLSHandshakeTimeout: 5 * time.Second,
},
}
resp, err := client.Do(req)
if err != nil {
if errors.Is(err, context.DeadlineExceeded) {
return c.Status(504).SendString("upstream timeout")
}
return c.Status(502).SendString("upstream error")
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
return c.Status(resp.StatusCode).Send(body)}
关键点：
- 必须用
http.NewRequestWithContext(ctx, ...)，不能先http.NewRequest()再.WithContext()（容易漏） -
Transport里的DialContext和ResponseHeaderTimeout必须显式设，否则建连或收 header 卡住时，ctx.Done()还没触发 - 错误判断优先用
errors.Is(err, context.DeadlineExceeded)，别只看err.Error()含义模糊
Fiber 中间件场景下如何透传 context 超时
如果你在中间件里统一做鉴权、埋点、重试，又需要调第三方 API，注意两点：
-
ctx.Locals是 Fiber 自维护 map，**不会自动同步到ctx.Context()**；你要调外部服务，必须显式调c.Context()拿原生 context - 不要复用全局未配置 timeout 的
http.DefaultClient；高并发下一个慢请求会拖垮整条链路，每个 handler 应该用自己配好的*http.Client - 若用了熔断器（如
gobreaker），注意它默认只把非nilerror 当失败；但很多 SDK 超时后返回nil, nil，需手动包装 error 或改用breaker.ExecuteWithFallback
最常被忽略的一点：Fiber 的 ctx.Context() 生命周期只到 handler 返回，而 http.Client 的连接池、TLS session 复用、DNS 缓存这些底层行为，都依赖 Transport 级别的 timeout 配置。只靠 context.WithTimeout 不够，DialContext 和 ResponseHeaderTimeout 缺一不可。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
