TCP心跳检测是应用层通过定时发送小数据包(如“PING”)来确认连接存活的机制,服务端用SetReadDeadline管理超时,客户端用time.Ticker定时发送,建议心跳间隔10秒、超时25秒、内容1~4字节并双向响应。

什么是TCP心跳检测
TCP本身没有内置心跳机制,所谓“心跳”是应用层通过定时发送小数据包(如空字节、固定字符串)来确认连接是否存活。它能及时发现对端异常断开、网络中断或防火墙超时断连等问题,避免长时间维持无效连接。
服务端如何实现心跳检测
服务端需为每个连接维护一个计时器,收到客户端心跳后重置;超时未收到则主动关闭连接。
- 使用
net.Conn.SetReadDeadline()设置读超时,每次读到数据(包括心跳)后调用SetReadDeadline(time.Now().Add(heartBeatTimeout)) - 在读循环中判断错误是否为
net.ErrDeadlineExceeded,是则说明心跳超时,关闭连接 - 可配合
sync.Map或带锁结构记录连接状态,便于管理与统计
客户端如何发送心跳包
客户端需启动独立协程,按固定间隔向服务端写入心跳数据(如"PING"或单字节0x01)。
- 使用
time.Ticker控制发送频率(如每10秒一次),避免用time.Sleep阻塞协程 - 写操作前检查连接是否仍有效(可用
conn.RemoteAddr()非空简单判断,更严谨需捕获写错误) - 若写失败(如
write: broken pipe),应停止心跳并关闭本地连接,触发重连逻辑
心跳协议设计建议
心跳不只靠“发得勤”,更要考虑协议健壮性和资源开销。
立即学习“go语言免费学习笔记(深入)”;
- 心跳内容尽量短(1~4字节),避免增加无谓带宽和解析负担
- 服务端收到心跳后建议回一个轻量响应(如
"PONG"),实现双向保活,防止单向断连被忽略 - 超时时间建议设为心跳间隔的2~3倍(如心跳10秒,超时设25秒),留出网络抖动余量
- 避免在心跳处理中做耗时操作(如数据库查询、日志刷盘),防止阻塞读循环
基本上就这些。Golang的并发模型和连接控制接口让心跳实现很直接,关键在超时管理与错误归因要清晰,别把网络错误当成业务错误处理。










