全网整合营销服务商

电脑端+手机端+微信端=数据同步管理

免费咨询热线:400-708-3566

如何在Golang中实现WebSocket心跳机制_保持连接活跃

Go中WebSocket心跳需服务端启用PingHandler并每25秒发ping、客户端每30秒发JSON心跳包,双方均需超时检测(服务端45秒、客户端60秒)并主动断连,同时注意Nginx超时配置与WriteMessage并发安全。

在 Go 中实现 WebSocket 心跳机制,核心是客户端与服务端协同发送 ping/pong 帧或自定义心跳消息,防止连接因中间代理(如 Nginx、负载均衡器)超时断开。标准 WebSocket 协议本身支持 Ping/Pong 控制帧,但很多 Go 的 WebSocket 库(如 gorilla/websocket)默认不自动响应 pong,需手动处理;同时,应用层心跳(如 JSON 消息)更可控、可监控,推荐两者结合使用。

服务端:启用 Ping 处理 + 定期发送 Ping

使用 gorilla/websocket 时,需显式设置 CheckOrigin、启用 SetPingHandler 并启动协程定期写入 ping:

  • 调用 conn.SetPingHandler 注册 pong 响应逻辑(收到 ping 自动回 pong)
  • 启动一个独立 goroutine,用 time.Ticker 每 25 秒调用 conn.WriteMessage(websocket.PingMessage, nil)
  • 设置读写超时(如 conn.SetReadDeadline),并在读循环中捕获 websocket.CloseMessage 或超时错误及时关闭连接

客户端:响应 Ping + 发送应用心跳

浏览器原生 WebSocket 会自动响应服务端 ping,无需额外处理;但为兼容性及可观测性,建议在 JS 客户端也定时发送 JSON 格式的心跳包(如 {"type":"heartbeat"}):

  • 使用 setInterval 每 30 秒 ws.send(JSON.stringify({type:'heartbeat'}))
  • 监听 message 事件,忽略服务端返回的纯 pong,只处理业务消息和自定义心跳响应
  • 连接异常时(onclose / onerror)触发重连逻辑,避免假死

双向超时控制:防连接滞留

仅发心跳不够,必须配合超时检测才能真正识别“假在线”:

  • 服务端为每个连接维护最后收到消息的时间戳(含 ping/pong 和业务消息),在读循环中更新
  • 另起 goroutine 定期扫描连接列表,若某连接超过 45 秒无任何活动,则主动 conn.WriteMessage(websocket.CloseMessage, websocket.FormatCloseMessage(websocket.CloseGoingAway, "")) 关闭
  • 客户端同样记录最后收到消息时间,若 60 秒内无响应(包括 pong 和心跳 ACK),视为断连并重连

注意事项与常见坑

实际部署中容易忽略以下细节:

  • Nginx 默认 proxy_read_timeout 是 60 秒,需设为大于服务端心跳间隔(如 75s),并配置 proxy_set_header Connection '' 避免连接被复用干扰
  • gorilla/websocket 的 WriteMessage 不是并发安全的,多个 goroutine 写需加锁或用 conn.WriteJSON + 单写协程通道模型
  • 不要依赖 SetPongHandler 来做业务逻辑——它只用于维持链路,业务心跳应走文本消息通道,便于日志追踪和协议扩展


# js  # json  # go  # nginx  # golang  # 浏览器  # websocket  # proxy  # 循环  # nil  # 并发 


相关文章: 昆明网站制作哪家好,昆明公租房申请网上登录入口?  如何在阿里云服务器自主搭建网站?  建站之星价格显示格式升级,你的预算足够吗?  网站微信制作软件,如何制作微信链接?  宝塔建站无法访问?如何排查配置与端口问题?  公司门户网站制作公司有哪些,怎样使用wordpress制作一个企业网站?  外汇网站制作流程,如何在工商银行网站上做外汇买卖?  如何快速搭建支持数据库操作的智能建站平台?  西安市网站制作公司,哪个相亲网站比较好?西安比较好的相亲网站?  建站中国官网:模板定制+SEO优化+建站流程一站式指南  西安专业网站制作公司有哪些,陕西省建行官方网站?  制作网站软件推荐手机版,如何制作属于自己的手机网站app应用?  建站上传速度慢?如何优化加速网站加载效率?  专业企业网站设计制作公司,如何理解商贸企业的统一配送和分销网络建设?  哪家制作企业网站好,开办像阿里巴巴那样的网络公司和网站要怎么做?  详解免费开源的.NET多类型文件解压缩组件SharpZipLib(.NET组件介绍之七)  移动端手机网站制作软件,掌上时代,移动端网站的谷歌SEO该如何做?  如何快速搭建个人网站并优化SEO?  网站制作知乎推荐,想做自己的网站用什么工具比较好?  在线流程图制作网站手机版,谁能推荐几个好的CG原画资源网站么?  ui设计制作网站有哪些,手机UI设计网址吗?  MySQL查询结果复制到新表的方法(更新、插入)  实现虚拟支付需哪些建站技术支撑?  网站制作专业公司有哪些,如何制作一个企业网站,建设网站的基本步骤有哪些?  php8.4新语法match怎么用_php8.4match表达式替代switch【方法】  定制建站是什么?如何实现个性化需求?  深入理解Android中的xmlns:tools属性  保定网站制作方案定制,保定招聘的渠道有哪些?找工作的人一般都去哪里看招聘信息?  建站主机服务器选购指南:轻量应用与VPS配置解析  如何通过主机屋免费建站教程十分钟搭建网站?  儿童网站界面设计图片,中国少年儿童教育网站-怎么去注册?  沈阳个人网站制作公司,哪个网站能考到沈阳事业编招聘的信息?  攀枝花网站建设,攀枝花营业执照网上怎么年审?  韩国代理服务器如何选?解析IP设置技巧与跨境访问优化指南  金*站制作公司有哪些,金华教育集团官网?  企业微网站怎么做,公司网站和公众号有什么区别?  如何快速查询网址的建站时间与历史轨迹?  寿县云建站:智能SEO优化与多行业模板快速上线指南  美食网站链接制作教程视频,哪个教做美食的网站比较专业点?  如何批量查询域名的建站时间记录?  中山网站推广排名,中山信息港登录入口?  如何通过虚拟主机空间快速建站?  如何使用Golang安装API文档生成工具_快速生成接口文档  建站中国必看指南:CMS建站系统+手机网站搭建核心技巧解析  宝塔面板创建网站无法访问?如何快速排查修复?  青岛网站建设如何选择本地服务器?  ,网页ppt怎么弄成自己的ppt?  建站之星展会模版如何一键下载生成?  免费制作小说封面的网站有哪些,怎么接网站批量的封面单?  企业在线网站设计制作流程,想建设一个属于自己的企业网站,该如何去做? 

您的项目需求

*请认真填写需求信息,我们会在24小时内与您取得联系。