go test -timeout 控制整个测试命令总耗时，超时即强杀进程；单个测试或子测试需手动用 context.WithTimeout 实现超时控制，并注意 rows.Err()、http.NewRequestWithContext 等关键点。
go test -timeout 控制的是整个测试命令的总耗时，不是单个 TestXxx 函数的超时。 它一到时间就 kill 进程，不区分当前在跑哪个测试、有没有子测试、goroutine 是否还在 sleep。想让某个测试函数或 t.Run() 自己超时，得手动加 context 控制。
go test -timeout 只管进程总时间
比如 go test -timeout 30s 表示从你敲下回车开始计时，30 秒一到，不管 TestDBQuery 还是 t.Run("slow-subtest") 正在执行，进程直接退出，报错 test killed with quit: ran too long (30s)。
常见误判点：
- IDE（如 VS Code Go 扩展）可能缓存旧参数，改了
-timeout没生效 —— 试试重启终端或清 IDE 测试缓存 - CI 平台（如 GitHub Actions）自带
timeout-minutes，它先触发的话，go test -timeout根本没机会运行 - 测试里用了
time.Sleep+select+time.After却没监听ctx.Done()，这种写法不响应进程级中断，只能靠强杀 - 调用了未设超时的
exec.Command().Run()，子进程不继承信号，主进程被杀后子进程可能残留
给单个 TestXxx 或 t.Run() 加超时要自己动手
Go 测试框架没有内置 “每个 t.Run() 单独设 timeout” 的能力。必须用 context.WithTimeout + 显式检查 ctx.Done()。
立即学习“go语言免费学习笔记（深入）”；
推荐做法：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 对简单场景：在
t.Run()内部创建ctx, cancel := context.WithTimeout(context.Background(), 500*time.Millisecond)，把ctx传给待测函数（如db.QueryContext、http.Client.Do），最后defer cancel() - 对通用封装：写一个辅助函数，比如
RunWithTimeout(t *testing.T, d time.Duration, f func(t *testing.T))，内部用 goroutine +select等待完成或超时，超时则调t.Fatal - 别漏清理：比如用了
httptest.Server，必须显式调srv.Close()，否则端口占着，下次测试直接失败 - 注意嵌套耗时：外层
go test -timeout 1m包含 setup/teardown 时间，别以为 10 个子测试各 5s 就刚好用满 —— GC、I/O、调度延迟都会吃掉
数据库查询测试最容易踩的超时坑
很多人只写 rows, err := db.QueryContext(ctx, sql, args) 并检查 err，但超时错误往往不出现在这里，而是在后续 rows.Next() 或 rows.Close() 时才返回 context.DeadlineExceeded。
正确模式：
rows, err := db.QueryContext(ctx, sql, args)
if err != nil {
return err
}
defer rows.Close()
for rows.Next() {
// scan
}
return rows.Err() // ← 这里才真正捕获超时或网络错误
另外，配置项建议用毫秒整数（如 "query_timeout_ms": 3000），而不是字符串 "3s" —— Go 标准库不直接支持 duration 字符串反序列化，容易解析失败 panic；定义结构体时用 int64 TimeoutMS，运行时转成 time.Duration(cfg.TimeoutMS) * time.Millisecond，并设默认值（如 5000），防止配置缺失导致无限等待。
HTTP 请求测试也得用 context，不能只靠 http.Client.Timeout
http.Client.Timeout 只控制「请求发起 → 响应体读完」这一段，不覆盖 DNS 解析、TLS 握手、连接池等待等前置阶段。这些卡住时，Timeout 不生效。
生产环境必须用 context.WithTimeout + req.WithContext(ctx)：
- 创建
ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second) - 用
http.NewRequestWithContext(ctx, ...)构造请求，再交给client.Do() - 别忘了
defer cancel()，否则可能泄漏 goroutine - 如果 handler 是自己写的，测试时可在里面加可控延迟（比如从 query 参数读
delay=500ms），比改客户端更轻量
最常被忽略的一点：超时时间从 context.WithTimeout 调用那一刻就开始计时，不是从 client.Do() 开始 —— 中间任何 setup 步骤都算在超时窗口内。
