单片机与物联网 / 系统课时
用 Keep Alive 检测失效连接
用 Keep Alive 检测失效连接
设备突然断网时,Broker 不一定能立即知道连接已经失效。本课用 MQTT Keep Alive 的发送间隔、PINGREQ/PINGRESP 和服务端超时规则,判断空闲连接何时应被关闭,并在本地观察真实心跳报文。
学习目标
- 说明 Keep Alive 与普通业务消息的关系。
- 用 10 秒参数计算 Broker 的约 15 秒失联边界。
- 通过 Mosquitto 调试输出确认心跳正常,并识别常见异常。
客户端什么时候必须发送心跳
客户端在 CONNECT 报文中给出 Keep Alive,单位为秒。若取值为 10,客户端两次发送 MQTT 控制报文的间隔就不能超过 10 秒;PUBLISH、SUBSCRIBE、PUBACK 等报文都能满足这一要求。只有没有其他控制报文要发送时,客户端才必须发送 PINGREQ。
Broker 收到 PINGREQ 后回复 PINGRESP。这组报文用于确认 MQTT 连接上的双向通信仍然可用,不承载温度、电量等业务数据。它也不等于设备传感器或业务进程必然健康。
在 MQTT 5 中,如果 Broker 在 CONNACK 中返回 Server Keep Alive,客户端必须改用服务端给出的值。Keep Alive 设置为 0 会关闭这一心跳机制,但 Broker 仍可能根据其他策略断开连接。
为什么服务端按一点五倍判超时
当有效 Keep Alive 为 10 秒时,如果 Broker 从最后一次收到客户端控制报文起,连续约 15 秒仍未收到下一条控制报文,就必须关闭该网络连接。计算依据是 10 × 1.5 = 15;这是服务端的失联判定规则,不是要求客户端每 15 秒发送一次心跳。
正常空闲连接会在不超过 10 秒的间隔内发出 PINGREQ 并收到 PINGRESP。若网络中断,即使客户端自认为仍已连接,只要 Broker 没收到新的客户端控制报文,就会触发超时。实际观测时间会受到网络延迟和程序调度影响。

客户端发送 PINGREQ 后如果在合理时间内收不到 PINGRESP,也应主动关闭连接并启动重连。协议没有规定一个统一的 PINGRESP 等待秒数,不能直接把 Broker 的 1.5 倍判定值当作客户端响应超时配置。
在本地观察 PINGREQ 与 PINGRESP
准备支持 MQTT 5 的 Mosquitto Broker 和 mosquitto_sub,假设测试 Broker 正在 127.0.0.1:1883 监听。执行下列命令后不要向 lab/idle 发布消息,保持连接空闲约 20 秒。
# -k 10 设置心跳间隔,-d 打印 MQTT 协议调试信息
mosquitto_sub -h 127.0.0.1 -p 1883 -V mqttv5 -i ka-probe-01 -t lab/idle -k 10 -d预期输出(摘录,连接和订阅日志已省略):
Client ka-probe-01 sending PINGREQ
Client ka-probe-01 received PINGRESP正常情况下能看到心跳报文成对出现;不同客户端版本的日志格式可能略有差异。观察完成后按 Ctrl+C 退出。若 Broker 返回了不同的 Server Keep Alive,心跳间隔应以其返回值为准。
心跳失败后应该检查什么
如果客户端从未打印 PINGREQ,先检查 SDK 网络事件循环是否持续运行;阻塞循环或线程休眠可能使心跳定时任务无法发送。若已有 PINGREQ 却迟迟没有 PINGRESP,再排查网络丢包、Broker 负载和连接关闭日志。
生产环境可以先按链路质量选取 30~60 秒量级的有效 Keep Alive,再结合实测掉线检测时延、心跳流量和客户端重连退避调整;不要靠设为 0 来掩盖频繁掉线。