context.WithTimeout不生效主因是子context未贯穿I/O或协程边界：goroutine未显式传ctx、数据库用Query而非QueryContext、HTTP请求未调用req.WithContext(ctx)，且中间件中必须显式重赋值c.Request = c.Request.WithContext(ctx)。
Go HTTP 服务中 context.WithTimeout 不生效的典型原因
超长链路请求超时失效，90% 是因为 context.WithTimeout 创建的子 context 没有贯穿到底层 I/O 或协程边界。HTTP handler 内部启动 goroutine 却没传入该 context，或调用第三方库（如数据库驱动、HTTP client）时用了默认 context，都会导致超时被绕过。
- 检查所有
go func() { ... }()是否显式接收并使用传入的ctx，不能只依赖闭包捕获外部变量 - 数据库操作必须用
db.QueryContext(ctx, ...)而非db.Query(...)；同理，http.Client.Do(req.WithContext(ctx))才有效 - 中间件里创建的 context 需通过
req = req.WithContext(newCtx)注入 request，再传递给下一层 handler
gin/gorilla/mux 框架中统一注入超时 context 的写法
框架本身不自动绑定超时，必须手动在入口 middleware 中完成 context 替换。以 gin 为例，gin.Context 的底层 *http.Request 可被增强，但直接改 c.Request.Context() 不影响后续 handler 内部对 c.Request 的读取 —— 必须用 c.Request = c.Request.WithContext(...) 显式覆盖。
- 正确写法：
func TimeoutMiddleware(timeout time.Duration) gin.HandlerFunc { return func(c *gin.Context) { ctx, cancel := context.WithTimeout(c.Request.Context(), timeout) defer cancel() c.Request = c.Request.WithContext(ctx) // 关键：必须重赋值 c.Next() } } - gorilla/mux 类似，用
middleware.Func包裹 handler，在内部调用next.ServeHTTP(w, r.WithContext(...)) - 注意：若 handler 内部又调用
time.Sleep或 CPU 密集计算，context 超时无法中断，需配合select { case 主动轮询
测试超时逻辑是否真正起作用的健壮方式
仅测 “返回 504” 不够 —— 很多实现只是提前 return，但后台 goroutine 仍在跑，造成资源泄漏和竞态。健壮测试必须验证两件事：响应及时返回 + 后台任务确实终止。
- 用
httptest.NewServer启服务，客户端设短 timeout（如 100ms），发起请求后立即检查响应状态码和 body - 在 handler 中启动一个带日志的 long-running goroutine，内部用
select { case ，然后断言日志是否输出“canceled” - 避免用
time.Sleep等待，改用sync.WaitGroup+ channel 收集 goroutine 结束信号，再做断言 - 注意：
testing.T.Parallel()与 context cancel 有微妙交互，建议超时测试禁用并行
gRPC 链路中跨服务超时传递失效的坑
HTTP 到 gRPC 的网关（如 grpc-gateway）或直连 gRPC client，若未将上游 context 透传到底层 ctx，下游服务的超时会从零开始计时。常见错误是手动构造 metadata.MD 却忽略 deadline 信息，或用 grpc.Dial 时未设置 WithBlock() 和超时选项。
立即学习“go语言免费学习笔记（深入）”；
- gRPC server 端必须用
ctx, cancel := context.WithTimeout(r.Context(), ...)，且所有 handler 函数签名保持func(ctx context.Context, req *pb.XXX) - client 调用时，务必用
ctx, cancel := context.WithTimeout(parentCtx, time.Second*5)，而非固定时间的time.Now().Add(...) - grpc-gateway 默认不转发 deadline，需启用
runtime.WithForwardResponseOption并手动提取grpc-timeoutheader 注入 context - 跨语言调用时，Java/Python client 若未设置
withDeadline，Go server 的 context 超时形同虚设
context.WithTimeout。 
