echo.WebSocket默认不处理心跳，因其底层基于gorilla/websocket，仅封装连接与消息收发，Ping/Pong帧需手动触发；SetPingHandler仅注册回调，不自动发Ping，必须配合time.Ticker定时调用WriteMessage发送PingMessage并正确设置读写超时。
为什么 echo.WebSocket 默认不处理心跳
因为 WebSocket 协议本身不强制要求心跳，echo 的 WebSocket 封装（基于 gorilla/websocket）只做连接建立和消息收发，底层的 Ping/Pong 帧需手动触发。很多开发者误以为启用 SetPingHandler 就自动保活，其实它只是注册回调，真正发 Ping 还得自己定时调用 WriteMessage(websocket.PingMessage, nil)。
常见错误现象：connection reset by peer 或客户端突然断连且无错误日志，往往是因为服务端没发 Ping、客户端超时主动关闭；或者服务端设置了 SetReadDeadline 但没配合 Ping 处理，导致读超时直接断开。
- 必须在
conn.SetPingHandler中显式调用conn.SetPongHandler回复，否则客户端Ping会失败 -
WriteMessage不是线程安全的，多个 goroutine 同时写会 panic，需加锁或用单协程控制发送 - 不要依赖
http.TimeoutHandler管理 WebSocket 连接生命周期——它对长连接无效
如何用 time.Ticker 主动发 Ping
最稳妥的方式是连接建立后立即启动一个独立 goroutine，用 time.Ticker 定期写 PingMessage。注意：不能在 HandleWebSocket 的主协程里阻塞等待，否则无法处理消息收发。
go func() {
ticker := time.NewTicker(30 * time.Second)
defer ticker.Stop()
for {
select {
case <-ticker.C:
if err := conn.WriteMessage(websocket.PingMessage, nil); err != nil {
return // 连接已断，退出
}
case <-done: // 外部控制信号，如 conn.Close() 后 close(done)
return
}
}
}()- 心跳间隔建议设为 30–45 秒，避开多数云负载均衡器（如 AWS ALB 默认 60 秒空闲超时）
- 务必检查
WriteMessage返回的err，网络异常时及时退出 goroutine，避免泄漏 - 用
donechannel 控制 goroutine 生命周期，而不是靠defer或全局变量
SetPingHandler 和 SetPongHandler 必须成对设置
客户端可能主动发 Ping（比如浏览器或某些 SDK），此时服务端若没注册 SetPongHandler，gorilla/websocket 会直接关闭连接。而 SetPingHandler 的回调函数里，必须立刻调用 conn.WriteMessage(websocket.PongMessage, nil)，否则客户端认为响应超时。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
conn.SetPingHandler(func(appData string) error {
return conn.WriteMessage(websocket.PongMessage, []byte(appData))
})
conn.SetPongHandler(func(appData string) error {
conn.SetReadDeadline(time.Now().Add(30 * time.Second))
return nil
})-
SetPongHandler是可选的，但强烈建议设置，并在其中重置ReadDeadline，防止因网络延迟导致误判超时 -
SetPingHandler的参数appData可原样回传给客户端，用于调试或时间戳校验 - 两个 handler 都运行在读协程中，避免在其中做耗时操作（如 DB 查询）
客户端未响应 Ping 时如何优雅关闭
服务端发了 Ping，但长时间没收到 Pong，说明客户端已失联。这时不能等 TCP 层探测（太慢），应主动关连接。关键是在写 Ping 前设置 WriteDeadline，并在失败后清理资源。
conn.SetWriteDeadline(time.Now().Add(10 * time.Second))
if err := conn.WriteMessage(websocket.PingMessage, nil); err != nil {
log.Printf("failed to send ping: %v", err)
conn.Close() // 主动关闭，触发 defer 或 on-close 逻辑
return
}-
WriteDeadline要比心跳间隔短（例如心跳 30s，deadline 设 10s），确保快速失败 - 关闭前记得通知业务层（如从用户映射表中删除
conn），否则可能造成内存泄漏 - 不要在
defer conn.Close()里做清理，因为WriteMessage失败后需要立即关，不是等函数返回
复杂点在于多实例部署时，心跳状态无法共享，单节点断连无法通知其他节点。如果业务强依赖实时在线状态，得引入 Redis 或消息队列做分布式协调——这已经超出框架层能解决的范围了。
