通过gorilla/websocket库实现WebSocket心跳机制,服务端定时发送ping消息,客户端自动响应pong以维持连接;2. 设置读取超时并注册PongHandler,收到pong时重置超时时间,确保连接活跃。

WebSocket连接在长时间无数据交互时容易被中间代理或防火墙断开,因此需要通过心跳检测维持连接。Golang中实现WebSocket心跳机制的关键在于定期发送ping/pong消息,并设置超时处理。以下是具体实现方式。
启用WebSocket的Ping/Pong机制
Go的gorilla/websocket库原生支持WebSocket的控制消息:ping和pong。服务端可以发送ping,客户端自动响应pong;或者客户端发送ping,服务端需手动回复pong。
建议服务端定时向客户端发送ping,客户端会自动回应pong,以此确认连接存活。
设置读写超时与Pong处理
为了检测客户端是否失联,需设置读取消息的超时时间,并注册Pong处理函数来更新最后一次收到pong的时间。
立即学习“go语言免费学习笔记(深入)”;
示例代码:
conn.SetReadDeadline(time.Now().Add(60 * time.Second))
conn.SetPongHandler(func(string) error {
conn.SetReadDeadline(time.Now().Add(60 * time.Second))
return nil
})
当收到pong消息时,重置读取超时时间,表示连接正常。
定时发送Ping消息
使用time.Ticker定期向客户端发送ping:
ticker := time.NewTicker(30 * time.Second)
defer ticker.Stop()
for {
select {
case <-ticker.C:
if err := conn.WriteControl(websocket.PingMessage, []byte{}, time.Now().Add(10*time.Second)); err != nil {
log.Println("ping error:", err)
return
}
case <-done: // 连接关闭信号
return
}
}
每隔30秒发送一次ping,若连续多次失败,则可判定连接已断开。
处理读取消息中的Ping请求
客户端可能也会发送ping,服务端应正确响应pong:
conn.SetPingHandler(func(appData string) error {
conn.WriteControl(websocket.PongMessage, []byte(appData), time.Now().Add(10*time.Second))
return nil
})
这样能确保双向通信正常,避免因未响应导致连接中断。
基本上就这些。通过定时发ping、处理pong、设置超时,就能有效维护WebSocket连接状态。关键点是读超时要大于ping间隔,留出网络延迟空间。不复杂但容易忽略细节。










