Go 1.27.1+ 的 testing/synctest 是唯一能稳定复现长连接断连逻辑的测试方案，通过隔离 TimeBubble 精确快进模拟心跳超时、NAT 静默回收、代理层断连及 ReadDeadline 更新等真实网络抖动场景，彻底替代不可靠的 time.Sleep。
用 testing/synctest 模拟心跳超时与连接抖动
Go 1.27.1+ 的 testing/synctest 是唯一能稳定复现长连接断连逻辑的测试方案。真实 time.Sleep 在 CI 上极易因调度抖动导致断言失败，而 synctest.NewTimeBubble() 可以精确快进到心跳超时点、触发 net.Error.Timeout()、甚至模拟连续两次读超时才断连的判定逻辑。
常见错误是把 time.Sleep 硬塞进测试里，比如写 time.Sleep(30 * time.Second) 等心跳超时——这在本地可能过，在流水线必然 flaky。
- 必须用
bubble.Advance(30 * time.Second)替代time.Sleep，时间推进完全可控 - 每个连接要单独建
synctest.TimeBubble，避免协程间时间状态污染 - 模拟 NAT 静默回收：先 Advance 到 25s 发心跳，再 Advance 10s（跳过响应窗口），此时下一次 Read 必然超时
- 验证
conn.SetReadDeadline是否被正确重置：在 bubble 中检查 deadline 是否随每次成功 Read 更新
构造带响应验证的心跳包并隔离解包逻辑
自测时最容易漏掉的是“心跳是否真被对端处理”，只测 Write 成功不等于链路存活。必须让服务端收到心跳后显式更新活跃时间，客户端才能基于下一次 Read 是否超时做判断。
错误做法是把心跳和业务包混在一起 decode，比如用 JSON 解析所有数据——代理或中间设备可能篡改换行符或截断字段，导致心跳包解析失败，误判为断连。
立即学习“go语言免费学习笔记（深入）”；
- 心跳包用固定长度二进制标识，如
[]byte{0x00, 0x01}，服务端用bytes.Equal(buf[:2], []byte{0x00, 0x01})快速识别 - 收到心跳后立即调
conn.SetReadDeadline(time.Now().Add(30 * time.Second))，不走业务解包流程 - 客户端发心跳后不等 PONG，但必须确保下一次 Read 能在 deadline 内返回——这才是保活有效性的真实指标
- 测试中可伪造服务端逻辑：收到心跳后故意延迟 35s 再返回，验证客户端是否在第二次 Read 时触发断连
复现代理层静默断连（Nginx/SLB 场景）
本地直连通不代表上线就稳。Nginx 默认 proxy_read_timeout 60s，阿里云 SLB 常设空闲超时 90s，这些值必须在测试中显式对齐，否则自测永远发现不了问题。
典型现象是：WebSocket 握手成功、心跳 Write 成功、但第 61 秒发业务消息直接失败，日志里没有任何连接关闭记录。
- 测试时启动一个 mock proxy：用
net.Listen("tcp", ":8080")+ 自定义io.Copy转发，并在空闲 65s 后主动conn.Close() - 客户端连接该 proxy，设心跳间隔 25s，
SetReadDeadline设为 30s —— 这样能在 proxy 断连后 5s 内捕获 Read 超时 - 不要依赖
conn.SetKeepAlivePeriod(10 * time.Second)来绕过，OS 层 keepalive 大部分被 proxy 丢弃，无效 - 关键检查点：proxy 关闭后，客户端是否在下一个 Read 周期报
read: connection reset by peer或io.EOF，而不是无限阻塞
验证 context 取消与 goroutine 泄漏的耦合关系
长连接自测最隐蔽的坑不是连不上，而是连上了却 never cleanup。gRPC 或 HTTP/2 客户端若没响应 ctx.Done()，服务端还在跑，客户端已超时退出，goroutine 和内存持续泄漏。
错误模式是：测试里用 context.WithTimeout(ctx, 5*time.Second) 创建 ctx，但服务端 handler 里没写 select { case ，导致连接假性“保持”。
- 测试中启动 goroutine 模拟长耗时业务（如
time.Sleep(10 * time.Second)），同时用ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second) - 观察服务端 goroutine 数量：调
cancel()后是否归零（用runtime.NumGoroutine()断言） - 客户端侧必须检查错误是否为
context.DeadlineExceeded或context.Canceled，不能统一重试 —— 对已取消的 ctx 重试只会加剧泄漏 - 用
pprof.GoroutineProfile在测试前后 dump 协程栈，比对是否有残留的 readLoop/writeLoop
真正难测的不是“连接断了”，而是“你以为它还连着”。所有自测必须围绕“最后一次 Read 是否如期超时”“cancel() 后 goroutine 是否彻底退出”“代理切断后是否立刻感知”这三个点展开，其余都是干扰项。
