一、問題概述
邊緣端設備（如 WebAccess、各類採集終端 / 網關等）向 APM 平台上傳數據後，平台側設備持續顯示離線狀態，此問題核心與數據上傳鏈路中斷相關，以下為通用排查流程，適用於所有邊緣端上傳場景。
二、核心數據上傳路徑
邊緣端設備 → 網路 / 防火牆策略層 → MQTT Broker → APM 平台關鍵邏輯：APM 設備在線狀態完全依賴 MQTT Broker 接收的邊緣端上報數據，Broker 未接收到數據，APM 必顯示離線，並非一定為 APM 平台本身故障。
三、前置準備：從 APM 平台獲取 Broker 配置資訊
排查前需先從 APM 平台提取真實有效的 MQTT Broker 連接配置，確保排查工具與邊緣端設備使用一致配置，獲取路徑如下：
- 登錄 APM 平台後，進入【IoT 數據接入管理】模塊
- 找到對應網關, 找到連接資訊模塊
- 提取核心配置：Broker 的 Host 地址、Port 端口、vhost 虛擬主機、認證用戶名、密碼、指定上報 Topic 格式
- 重點備註：APM 平台中 Broker 認證用戶名格式為「vhost: 用戶名」，需按此格式完整使用
四、通用排查步驟（按優先級執行）
步驟 1：先確認 WebAccess 主機可正常解析 MQTT Broker 網域
操作位置：WebAccess 節點主機（執行 WebAccess Node 的電腦）
操作方式：開啟 CMD 執行
ping <broker-domain>
nslookup <broker-domain>
步驟 2：確認 1883 / 8883 連線埠可正常連外
操作位置： 一樣在 WebAccess 主機
操作方式：CMD 或 PowerShell 測試連線
telnet <broker-domain> 1883
telnet <broker-domain> 8883
步驟 3：驗證 MQTT Broker 是否接收邊緣端數據
- 工具：使用 MQTTBox/MQTTX/MQTT Explorer 等第三方 MQTT 測試工具
- 操作：按步驟 3 提取的APM 平台 Broker 配置，完整填寫至測試工具，建立與 Broker 的連接
- 驗證：連接成功後（工具顯示 Connected），訂閱 APM 指定的上報 Topic，觀察工具是否能接收到邊緣端的 data 封包
- 結果判定：
-
訂閱完全沒有訊息 → 問題在 WebAccess 側
-
有收到資料訊息 → 問題在 InsightAPM 平台側
五、MQTT Broker 排查工具操作示意（以 MQTTBox 為例）
-
打開工具新建 MQTT Client，完整填寫從 APM 提取的 Broker 配置（Host/Port/ 帳密等），保存後建立連接；
-
連接成功後點擊【Add subscriber】，輸入 APM 指定的 Topic 格式（無空格、替換實際憑證 ID 等變量）；
Topic: /wisepaas/scada/{NodeID}/data -
QoS 按 APM 配置選擇（默認 0 - Almost Once），點擊【Subscribe】訂閱，觀察是否有 data 封包持續上報。
六、總結
邊緣端上傳 APM 後設備離線，90% 以上為前端鏈路問題（設備配置 / 網路防火牆），建議優先按上述流程驗證 Broker 收數狀態，再根據結果定向排查；若確認為 APM 平台側問題，請聯繫研華WISE-IoT團隊處理。
