MQTT over WebSocket 客戶端
通過 WebSocket 連接 MQTT broker,訂閱和發佈文本或二進制消息,支持 MQTT 3.1.1 與 5.0。
連接、訂閱和發佈會直接與指定 broker 通信。
使用 MQTT WebSocket 監聽端點
請輸入帶 WebSocket 路徑的 ws:// 或 wss:// broker 地址。1883 等原生 MQTT TCP 端口不能直接作為瀏覽器 WebSocket 端點。本工具使用 MQTT.js 5.16.1 和 MQTT 協議,不是原始 WebSocket 回顯格式。示例只填入演示地址與主題,不會自動連接或訂閱。
選擇 MQTT 3.1.1 或 5.0,設置 broker 憑據及客戶端 ID。清理會話時,留空 ID 會用瀏覽器密碼學隨機源生成新的 23 位字母數字 ID。持久會話需顯式 ID;另一個使用相同 ID 的客戶端可能擠掉當前連接。安全頁面通常需要 WSS,仍受服務器 Origin 檢查、TLS 和瀏覽器策略約束。沒有服務端代理或原生 TCP 傳輸。
訂閱、發佈與確認
訂閱過濾器的 + 佔一個完整主題層級,# 需佔最後完整層級;允許空層級。共享過濾器使用 $share/group/filter,需 broker 支持。首層通配符不會自動選擇 $SYS 主題。發佈主題不能包含通配符。
選擇請求的訂閱 QoS,再查看實際 SUBACK 授權。發佈 QoS 0 在套接字寫入後完成,QoS 1 等待 PUBACK,QoS 2 等待 PUBCOMP。這些是協議完成狀態,不代表訂閱應用已處理消息。入站記錄保留主題、消息 QoS、retain/dup 標記、準確十六進制字節,以及有效時的 UTF-8 文本。
文本按 UTF-8 編碼,十六進制接受完整字節對與空白分隔,支持空正文。保留發佈會替換 broker 存儲值,空的保留消息可刪除該保留值。取消訂閱在 broker 確認後移除過濾器,不會清除 broker 的保留數據。
會話與連接清理
清理選項在 3.1.1 中表示 Clean Session,在 5.0 中表示 Clean Start。MQTT 5 會話過期可設 0–86,400 秒,3.1.1 不支持該字段。Session Present 來自 CONNACK。本工具只使用內存存儲,清除、重新打開頁面或創建新客戶端後不會恢復未完成的 QoS 事務;broker 持久會話本身不能保證無損恢復。
不自動重連、恢復訂閱或排隊離線 QoS 0 消息,新連接需手動發起。連接超時覆蓋 CONNACK 握手,操作超時覆蓋發佈/訂閱/取消訂閱回調,均為 1–30 秒。操作超時會停止連接,避免操作一直處於未決狀態;超時前 broker 可能已執行操作。
斷開會請求 MQTT DISCONNECT,最多等待兩秒後強制清理。修改連接設置或清除會停止舊客戶端並忽略遲到回調;修改主題或正文保留連接。離開頁面會清理資源,不將憑據、會話或日誌寫入瀏覽器存儲。不提供遺囑消息設置及全部 MQTT 5 高級屬性。
上限與導出
最多跟蹤 32 個訂閱過濾器、等待 20 個操作,消息正文限 256 KiB。客戶端 ID 限 128 UTF-8 字節;MQTT 文本字段拒絕控制字符、NUL、代理項和非字符碼點。用戶名與密碼需符合協議字節上限。Keepalive 可設 0–300 秒,0 表示不啟用協議保活。
日誌最多保留 1,000 條或 2 MiB 的緊湊事件 JSON,達到上限會斷開。MQTT 庫及瀏覽器可能先收到數據,再執行應用層正文檢查;MQTT 5 還聲明 1 MiB 最大數據包。本工具用於手動調試,不用於壓力測試。
預覽只顯示前 200,000 字符,複製與下載保留完整的有界日誌。連接記錄不包含用戶名或密碼,但 broker 錯誤、主題和正文仍可能含私密信息。JavaScript 不能繞過 broker 的認證或授權。
常見問題
可以連接 mqtt:// 或普通 WebSocket 回顯服務器嗎?
不可以。請使用 broker 的 MQTT over WebSocket 監聽端點,並設置正確路徑、版本與憑據。
QoS 2 是否代表業務操作只執行一次?
不是。它的保證屬於參與方之間的 MQTT 協議投遞;應用處理、持久恢復和下游系統有各自的行為。
為什麼取消訂閱後仍可能到一條消息?
已經接收或正在傳輸的消息可能與確認交錯。取消訂閱改變 broker 的訂閱,不會撤銷已經送達的工作。
其他語言
參考資料
我們如何確保結果正確
我們使用以下自動化測試驗證此工具。下方保留測試案例的原始名稱,方便查看實際斷言及重現。
- 驗證方法
- 檢查 topic、QoS、協議版本和二進制載荷;集成用例連接本地 broker 檢查認證、保留消息和會話。
- 對比依據
- Mosquitto 的 WebSocket broker 與固定消息/事件斷言。
- 驗證範圍
- 真實 broker 用例需要 Mosquitto 環境;缺失環境時不能把模擬測試通過當作完整互操作通過。
測試原始碼與案例(點選檔名檢視)
-
mqtt-graphql-tools.test.js
- MQTT strict URL, credentials, protocol, session and time option validation
- MQTT topic filters handle empty levels, shared groups, wildcards and forbidden text
這些測試涵蓋列出的樣本和邊界,不代表所有輸入都已證明正確。往返測試和使用同一依賴套件的檢查,不屬於獨立交叉驗證。