net.dialtimeout已弃用，仅控制tcp握手且无法中断dns查询；应改用net.dialer.dialcontext配合context.withtimeout实现dns→tcp→tls全链路超时控制。
net.DialTimeout 已被弃用，别再用了。Go 1.17 起官方标记为 deprecated，govet 会警告，且行为不可靠——它只管 TCP 握手，完全不控制 DNS 解析超时。你看到的 "i/o timeout" 很可能来自 30 秒 DNS 查询失败，根本没走到 connect 阶段。
为什么 net.DialTimeout 返回超时却卡在 DNS 阶段
常见错误现象是调用 net.DialTimeout("tcp", "api.example.com:443", 2*time.Second) 后，程序等了 30 秒才返回错误。这不是 bug，而是设计缺陷：net.DialTimeout 底层只是包装了 net.Dial + time.AfterFunc，无法中断正在进行的 DNS 查询（尤其在使用系统 resolver 时）。DNS 超时由操作系统决定（Linux 默认 30 秒），Go 完全无感知。
- DNS 查询阶段不受控，
Timeout参数对它无效 - TCP 握手阶段才真正起作用，但前提是 DNS 已成功返回 IP
- 错误类型是
*net.OpError，但判断只能靠字符串匹配"i/o timeout"，不可靠 - 不支持
context，无法与 cancel、deadline 传播集成
替代方案：用 net.Dialer.DialContext 配合 context.WithTimeout
这是当前唯一推荐、全链路可控的方式，覆盖 DNS 查询 → TCP 连接 → TLS 握手（若后续封装）整个拨号流程。
- 必须先创建
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)，并在 defer 中调用cancel() -
ctx不能复用，也不能在cancel()后继续使用 - 构造
*net.Dialer，显式设Timeout和KeepAlive（后者防 NAT 断连） - 调用
dialer.DialContext(ctx, "tcp", "example.com:443")，不是net.DialContext（后者用默认 dialer） - 超时错误统一用
errors.Is(err, context.DeadlineExceeded)判断，比类型断言更健壮
HTTP 客户端场景下千万别只配 Client.Timeout
http.Client.Timeout 是兜底总开关，但它会覆盖 Transport 层所有精细配置，且无法定位卡点在哪——是 DNS？TLS？还是服务端发了 header 就不发 body？
- 生产环境应禁用
Client.Timeout（设为 0），改用context.WithTimeout构造请求上下文 -
http.NewRequestWithContext(ctx, ...)才是请求生命周期的真实控制器 -
http.Transport中重点配：DialContext（含*net.Dialer{Timeout: 3*time.Second}）、TLSHandshakeTimeout（HTTPS 必设）、ResponseHeaderTimeout（防“半开连接”） - 务必关闭
resp.Body，否则连接无法归还连接池，MaxIdleConnsPerHost很快打满
读写阶段超时和建连超时完全独立
连接成功 ≠ 安全。漏掉任一环节都可能卡死几分钟。
-
conn.SetReadDeadline和conn.SetWriteDeadline必须每次 I/O 前重设——因为 deadline 是time.Time绝对时间点，不是持续时间 - 常见错误：初始化时算好一个固定时间点反复传入，导致第二次
Read()立即返回os.ErrDeadlineExceeded - 每次调用前必须重新调用
conn.SetReadDeadline(time.Now().Add(3 * time.Second)) -
SetWriteDeadline尤其关键：内核 send buffer 满、对端接收窗口为 0 时，Write()可能 hang 数分钟，不设就等于放弃 goroutine 健壮性
实际项目里最容易漏掉的一点：很多人写了 context.WithTimeout，但没检查 err 类型，导致超时错误被当成普通网络错误处理；还有人以为 *net.Dialer.Timeout 只管 TCP 握手，其实它覆盖从解析域名开始的所有步骤——除非你手动拆解 DNS 查询（用 net.Resolver 配独立 ctx），否则没法区分 DNS 超时和连接超时。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
