Go 的 SetKeepAlive 默认不生效，必须手动调用 SetKeepAlive(true) 并配合 SetKeepAlivePeriod（Go 1.19+）设置探测间隔，且需类型断言为 *TCPConn；该设置仅影响内核层，中间设备和应用层协议仍需协同保障连接存活。
Go 的 SetKeepAlive 默认不生效，必须手动开启
Go 的 net.Conn 默认关闭 TCP keepalive，即使你调用了 SetKeepAlive(true)，底层 socket 也不会自动发送探测包。这是因为 Go 在设置 SO_KEEPALIVE 后，并不默认配置操作系统级的保活参数（如间隔、重试次数），而 Linux/Windows 默认的 keepalive 行为往往太慢（例如 Linux 默认 2 小时才触发第一次探测）。
实操建议：
- 必须先调用
conn.SetKeepAlive(true)启用 keepalive 标志 - 再通过
conn.(*net.TCPConn).SetKeepAlivePeriod(d time.Duration)设置探测间隔（仅 Go 1.19+ 支持；旧版本需用syscall或golang.org/x/sys/unix手动 setsockopt） - 注意：该方法只对 *
net.TCPConn有效，net.Listener.Accept()返回的是net.Conn接口，需类型断言 - 若运行在容器或 NAT 网关后，实际探测间隔还受中间设备（如云厂商 SLB、iptables conntrack timeout）影响，不能只依赖 Go 层设置
SetKeepAlivePeriod 在不同 Go 版本的行为差异
Go 1.19 引入了 SetKeepAlivePeriod，但它的实现是“尽力而为”：Linux 上会调用 setsockopt(..., TCP_KEEPINTVL) 和 TCP_KEEPCNT，但 Windows 上仅设置 SO_KEEPALIVE 标志，不支持自定义周期（由系统策略决定）。
常见错误现象：
立即学习“go语言免费学习笔记（深入）”；
- 在 Windows 上调用
SetKeepAlivePeriod(30*time.Second)无报错，但 Wireshark 抓不到 30s 一次的 ACK 探测包 - Go 1.18 及更早版本直接调用该方法会 panic：“
method SetKeepAlivePeriod not found”，因为*TCPConn尚未暴露该方法 - 跨平台部署时，若只测试 Linux，容易误判保活逻辑已生效
为什么只设 SetKeepAlivePeriod 还不够？
TCP keepalive 是三层协作机制：应用层启用 + 内核协议栈配置 + 中间网络设备放行。Go 设置的只是其中一环。
使用场景与风险点：
- 长连接服务（如 MQTT broker、RPC server）依赖它检测僵死连接，但若客户端突然断电或拔网线，仍需配合应用层 ping-pong 协议才能快速感知（keepalive 最小粒度通常 ≥ 1s，且首次探测前有 idle 延迟）
- 某些云环境（如 AWS ALB、阿里云 SLB）默认 4 分钟无流量断连，此时即使 Go 设了 30s 探测，SLB 也可能在第 1 次探测前就 kill 连接
- 频繁调小
SetKeepAlivePeriod（如 - Android/iOS 移动端后台进程可能被系统休眠，导致 keepalive 包发不出，此时应用层心跳更可靠
一个安全可用的保活初始化写法
不要只依赖系统 keepalive。下面这段代码在 accept 连接后立即配置，兼顾兼容性与可观测性：
if tcpConn, ok := conn.(*net.TCPConn); ok {
tcpConn.SetKeepAlive(true)
// Go 1.19+
if err := tcpConn.SetKeepAlivePeriod(45 * time.Second); err != nil {
log.Printf("failed to set keepalive period: %v", err)
}
// 可选：降低 idle 时间（Linux only，需 syscall）
if err := setTCPKeepAliveIdle(tcpConn, 15); err != nil {
log.Printf("failed to set keepalive idle: %v", err)
}
} else {
log.Println("not a *net.TCPConn, skip keepalive setup")
}
其中 setTCPKeepAliveIdle 需用 golang.org/x/sys/unix 调用 unix.SetsockoptInt 设置 TCP_KEEPIDLE。这个细节常被忽略：没有显式设 TCP_KEEPIDLE，即使 SetKeepAlivePeriod 生效，也要等默认 idle（如 Linux 的 7200s）过去才开始探测。
真正难的不是调哪个函数，而是搞清你的连接路径上到底有几道超时机制——内核、中间设备、对方应用层，每一道都可能比你设的 SetKeepAlivePeriod 更早切断连接。
