必须显式设置HTTP客户端超时、IPv4/IPv6绑定、HTTP/2启用及DNS解析策略：超时需配置Client.Timeout或Transport各阶段超时；监听应避免默认双栈失败，改用0.0.0.0或net.Listen；HTTP/2仅支持TLS且须用ListenAndServeTLS；DNS可自定义Resolver防卡顿。
设置 HTTP 客户端超时避免连接卡死
Go 默认的 http.Client 没有设置超时，遇到网络抖动或服务无响应时会无限等待，导致 goroutine 泄漏。必须显式配置 Timeout 或更精细的 Transport 超时参数。
-
Timeout是总超时（连接 + 读写），适合简单场景：client := &http.Client{ Timeout: 10 * time.Second, } - 需要分别控制连接、TLS 握手、响应头读取等阶段时，应自定义
Transport：transport := &http.Transport{ DialContext: (&net.Dialer{ Timeout: 5 * time.Second, KeepAlive: 30 * time.Second, }).DialContext, TLSHandshakeTimeout: 5 * time.Second, ResponseHeaderTimeout: 3 * time.Second, ExpectContinueTimeout: 1 * time.Second, } - 注意：若同时设置了
Client.Timeout和Transport的超时，以更短者为准；Transport中未设置的字段仍会 fallback 到默认值（如MaxIdleConns默认是 100）
监听地址与端口时正确处理 IPv4/IPv6 双栈
使用 http.ListenAndServe(":8080", handler) 默认绑定 [::]:8080（IPv6 双栈），但在某些容器或老系统中可能因 IPv6 不可用而启动失败，报错类似 listen tcp [::]:8080: bind: cannot assign requested address。
- 明确指定 IPv4 地址可绕过问题：
http.ListenAndServe("0.0.0.0:8080", handler) - 若需兼容双栈且确保启动成功，建议用
net.Listen手动创建 listener，并检查错误：l, err := net.Listen("tcp", ":8080") if err != nil { log.Fatal(err) // 区分是地址冲突还是协议不支持 } http.Serve(l, handler) - Docker 环境下尤其要注意：Alpine 镜像默认禁用 IPv6，
[::]绑定会失败；Kubernetes Pod 若未启用ipv6feature gate，也会触发同类问题
启用 HTTP/2 需要 TLS 且不能复用非 TLS 的 Server
Go 的 http.Server 在启用 HTTPS 后自动支持 HTTP/2，但前提是使用 ListenAndServeTLS 或传入 *tls.Config；直接在 HTTP Server 上调用 server.ServeTLS 不生效，也不会报错，客户端仍走 HTTP/1.1。
- 正确方式（必须用
ListenAndServeTLS）：server := &http.Server{ Addr: ":443", Handler: handler, } log.Fatal(server.ListenAndServeTLS("cert.pem", "key.pem")) - 若已有明文 server 实例，不能通过修改字段开启 HTTP/2；HTTP/2 协议层依赖 TLS ALPN 协商，纯 TCP 连接无法降级协商
- 本地开发测试时，可用
generate_cert.go工具生成自签名证书，但浏览器会提示不安全；curl --http2 -k https://localhost:443可验证是否实际走 HTTP/2
调试 DNS 解析慢或失败时替换默认 Resolver
Go 默认使用系统 /etc/resolv.conf，但在容器或某些云环境里该文件可能缺失、过期，或指向不可达的 DNS 服务器，导致 net/http 请求卡在 lookup 阶段。
立即学习“go语言免费学习笔记（深入）”；
- 可通过
net.DefaultResolver替换为指定 DNS：net.DefaultResolver = &net.Resolver{ PreferGo: true, Dial: func(ctx context.Context, network, addr string) (net.Conn, error) { return net.DialContext(ctx, network, "8.8.8.8:53") }, } - 更稳妥的做法是在
http.Client级别控制，避免全局污染：client := &http.Client{ Transport: &http.Transport{ DialContext: (&net.Dialer{ Resolver: &net.Resolver{ PreferGo: true, Dial: func(ctx context.Context, network, addr string) (net.Conn, error) { return net.DialContext(ctx, network, "1.1.1.1:53") }, }, }).DialContext, }, } - 注意：Go 1.19+ 支持
net.Resolver.LookupHost缓存，但默认不启用；高频解析场景建议加一层内存缓存，避免重复 DNS 查询
真正影响线上稳定性的往往不是协议选型，而是超时设置粒度、DNS 解析路径、以及 IPv6 启用时机这些看似边缘的配置点。改完记得压测——尤其是模拟 DNS 返回 NXDOMAIN 或 TCP connect timeout 的情况，否则上线后才暴露就晚了。
