云消息队列 MQTT 版：设备状态查询

操作步骤

1. 登录云消息队列 MQTT 版控制台，并在左侧导航栏单击实例列表。

2. 在顶部菜单栏选择目标地域，然后在实例列表中单击实例名称进入实例详情页面。

3. 在实例列表中找到目标实例，在其操作列中，选择更多 > 设备状态查询。

4. 在设备状态查询页面，设置Group ID和Device ID，然后单击查询。

   查询结果相关字段说明如下：

   字段	说明
   设备状态
   Client ID	客户端的ID。
   在线状态	客户端的在线状态： 在线 离线
   客户端地址	客户端的IP地址。
   cleanSession	客户端的会话是否清除，详细信息，请参见cleanSession。
   最后更新时间	客户端状态的最后更新时间。
   订阅关系
   父级 Topic	客户端订阅的消息主题，MQTT的一级Topic。
   子级 Topic	MQTT的二级Topic，甚至三级Topic都是父级Topic下的子类。
   QoS	客户端与服务端消息传输的服务质量级别，详细信息，请参见QoS。

   Client ID 冲突排查

   当系统提示 clientId conflict（Client ID 冲突）时，表示同一 Client ID 同时发起了多个重复连接。系统会保留最新连接并将旧连接互踢下线。

   冲突现象与原因

   客户端 ID 在同一 MQTT 实例中必须全局唯一。当设备或应用在多处使用相同的 Client ID 发起连接时，即会触发互踢：系统保留最后建立的连接，断开之前存在的同名连接。

   排查方法

   在查询结果页面，单击设备轨迹页签，查看该设备的连接历史记录。若在短时间内存在多条来自不同接入点或 IP 地址的连接记录，且记录的时间段存在重叠，即可确认发生了 Client ID 冲突互踢。可通过查看来源信息（接入点地址或 IP）判断是否有多个客户端使用了相同的 Client ID 建立了重复连接。

   解决建议

   检查代码或设备配置，确保每个设备使用全局唯一的 Client ID，避免多设备或多进程并发使用同一 Client ID 建立连接。

   在查询结果页面单击设备轨迹和消息轨迹页签，您还可以查看到指定设备的轨迹信息和设备消息列表。查询结果的字段和详细说明，请参见设备轨迹查询和消息轨迹查询。

常见问题

如何确认 MQTT 订阅关系是否失效或当前是否生效？

目前控制台暂无直接的"订阅失效历史"查询入口。可通过以下方式确认订阅关系的当前状态：

1. 登录控制台，进入设备状态查询功能，输入 Group ID 和 Device ID 后单击查询。

2. 在查询结果的订阅关系字段中，确认设备当前是否已成功订阅目标 Topic。

若需排查历史失效问题，建议结合设备端日志分析：确认设备重连后是否发送了 SUBSCRIBE 报文。需要注意，即使 cleanSession=false，设备重连后也需主动重新发送 SUBSCRIBE 报文，才能接收新消息。可结合连接日志推断订阅状态在特定时间段的变化情况。

如何查看设备的精确离线时间或判断监控显示的离线是否准确？

可通过以下方式查看设备的精确上下线时间：

1. 在设备状态查询页面，单击设备轨迹页签，查看该设备精确的上线和下线时间点记录。

若控制台未显示数据，或设备轨迹显示设备在线，但监控图表显示离线，可能是由于监控数据采集存在延迟所致。建议刷新页面并查看最新连接数。

需要注意，查询结果中的最后更新时间字段仅代表客户端状态最后一次发生变更的时间，并非设备精确的断开连接时刻。如需确认设备的精确断联时刻，应以设备轨迹页签的记录为准。

如何查看 MQTT 实例的同时在线连接数及明细？

可通过以下方式查看 MQTT 实例的连接数信息：

1. 在 MQTT 实例详情页面，可查看该实例当前同时在线连接数的概览数值。

2. 如需查看具体设备的在线状态明细（连接数明细），可使用本文档所述的设备状态查询功能，按 Group ID 和 Device ID 逐设备查询具体数值。

3. 如需查看历史连接数趋势或计费相关的连接统计，请参见相关计费文档或实例监控图表。

相关文档

如果需要查询设备的轨迹，请参见设备轨迹查询。