S↗ smart-tools.ai

工業 IoT／SCADA · SDK / protocol

Eclipse Paho

Eclipse Foundation

利用支援的客戶端函式庫串接 MQTT 訊息。

官方文件下載開發規格

ECLIPSE PAHO / DEVELOPER FIELD GUIDE

選對接口，定義可驗證的結果。

公司／專案背景、十個技術入口，以及每份引用的實作分析。

2026-10-08 · 串接尚未實測

公司／專案背景全貌

依官方公司或專案自述撰寫的原創概要；完整原文請見來源。

Eclipse Paho · About
專案Eclipse Paho 提供裝置及應用連線所需的開源訊息協定實作，主要為跨語言 MQTT 用戶端。
角色與範圍這是用戶端函式庫家族，非託管 MQTT broker。需分別選擇協定、語言及發行版；broker 存取與業務處理由應用負責。
官方 About 完整原文 ↗
About 引用 — TA 分析
適用角色進行 AI 供應商初選的採購、合作夥伴與產品負責人。
本站評估用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。

已核對官方來源，未執行 broker 連線。部分產生文件仍有歷史版本標示；執行環境支援以固定發行版及目前儲存庫為準。此處 C 參考頁為較舊 MQTT v3 文件。

十項技術入口比較

依實作決策選出的十個技術文件入口，非十套獨立 SDK 或官方排名。

依要完成的工作選擇
接口用途與 TA
01 · Python ClientAPI / SDK / developer guide以 MQTT 3.x 或 5 回呼連線、發布及訂閱。Python 閘道工程師
02 · Python publish / subscribe helpersAPI / SDK / developer guide單次發布及簡易訂閱輔助函式。小型遙測腳本開發者
03 · Python callback migrationAPI / SDK / developer guide從 1.x 升級至 2.x 時調整回呼。既有 Python 整合維護者
04 · Python network loop and session limitsAPI / SDK / developer guide選擇事件迴圈策略並審視重連／工作階段限制。可靠訊息系統維護者
05 · C MQTTClientAPI / SDK / developer guide偏同步式 MQTT 用戶端 API。C 遙測應用工程師
06 · C MQTTAsyncAPI / SDK / developer guide回呼導向的連線、發布及訂閱。事件驅動原生用戶端工程師
07 · C++ clientAPI / SDK / developer guideModern C++ 阻塞／非阻塞 MQTT API，支援可設定持久儲存。原生閘道工程師
08 · Java clientAPI / SDK / developer guideMqttAsyncClient 回呼及同步 MqttClient 包裝。JVM 應用工程師
09 · Go MQTT 3 clientAPI / SDK / developer guide非同步 MQTT 3.1／3.1.1 發布及訂閱。Go 服務工程師
10 · Browser JavaScript clientAPI / SDK / developer guide透過 WebSocket 建立瀏覽器 MQTT 連線。網頁遙測介面工程師

逐份文件分析

能力摘要依據官方文件；限制與建議測試為本站工程評估。

01

API / SDK / developer guide

Python Client

Python Client · TA
目標讀者 TAPython 閘道工程師
官方文件能力以 MQTT 3.x 或 5 回呼連線、發布及訂閱。
輸入 → 輸出Broker 設定與主題內容 → 回呼及訊息資訊。
執行環境固定 paho-mqtt 版本及 broker 憑證／TLS 設定。
本站選型評估送出 CONNECT 不等於成功 CONNACK；MQTT 5 使用 clean_start 而非 clean_session。
本站建議驗證解讀內容前核對連線原因及訂閱結果。
官方文件 · Python Client ↗
02

API / SDK / developer guide

Python publish / subscribe helpers

Python publish / subscribe helpers · TA
目標讀者 TA小型遙測腳本開發者
官方文件能力單次發布及簡易訂閱輔助函式。
輸入 → 輸出主題、內容及連線選項 → 發布完成或訊息。
執行環境Python 用戶端及可存取的授權 broker。
本站選型評估空內容是實際零長度訊息；callback 訂閱會持續阻塞。
本站建議驗證區分觀測時段無訊息與收到空內容訊息。
官方文件 · Python publish / subscribe helpers ↗
03

API / SDK / developer guide

Python callback migration

Python callback migration · TA
目標讀者 TA既有 Python 整合維護者
官方文件能力從 1.x 升級至 2.x 時調整回呼。
輸入 → 輸出舊回呼簽名 → 明確版本及修訂原因處理。
執行環境依套件發行版固定套件與支援的 Python 版本。
本站選型評估VERSION1 已棄用；不可直接沿用舊非零數字代碼。
本站建議驗證用 VERSION2 樣例核對接受與拒絕 CONNACK 映射。
官方文件 · Python callback migration ↗
04

API / SDK / developer guide

Python network loop and session limits

Python network loop and session limits · TA
目標讀者 TA可靠訊息系統維護者
官方文件能力選擇事件迴圈策略並審視重連／工作階段限制。
輸入 → 輸出迴圈生命週期及發布資訊 → 進度與協定完成。
執行環境目前儲存庫要求 Python 3.9 以上；須固定發行版。
本站選型評估不可混用迴圈模式。Python 工作階段狀態不會跨程序重啟持久保存。
本站建議驗證同時保留發布完成證據與應用收件證據；評估重播及去重。
官方文件 · Python network loop and session limits ↗
05

API / SDK / developer guide

C MQTTClient

C MQTTClient · TA
目標讀者 TAC 遙測應用工程師
官方文件能力偏同步式 MQTT 用戶端 API。
輸入 → 輸出連線選項與訊息 → 回傳值及傳入訊息。
執行環境Paho C 函式庫、目標編譯器及 broker。
本站選型評估此較舊產生文件描述 MQTT v3；MQTTClient 非執行緒安全，部分呼叫會阻塞。
本站建議驗證對照已安裝標頭／發行版，序列化存取並限制等待時間。
官方文件 · C MQTTClient ↗
06

API / SDK / developer guide

C MQTTAsync

C MQTTAsync · TA
目標讀者 TA事件驅動原生用戶端工程師
官方文件能力回呼導向的連線、發布及訂閱。
輸入 → 輸出用戶端選項及操作 → 非同步回呼。
執行環境Paho C 非同步函式庫及回呼生命週期管理。
本站選型評估產生文件較舊；重連及離線發布須查對應發行版。
本站建議驗證依要求維持緩衝區生命週期，關聯完成事件後才釋放資源。
官方文件 · C MQTTAsync ↗
07

API / SDK / developer guide

C++ client

C++ client · TA
目標讀者 TA原生閘道工程師
官方文件能力Modern C++ 阻塞／非阻塞 MQTT API，支援可設定持久儲存。
輸入 → 輸出用戶端設定及訊息 → token／回呼與內容。
執行環境C++17、CMake 及相容 Paho C；目前 README 要求 C 1.3.16 以上。
本站選型評估TLS 及內含 C 選項影響建置；不可假設所有二進位均含 TLS。
本站建議驗證固定兩個函式庫版本並核對持久儲存／重連失敗情境。
官方文件 · C++ client ↗
08

API / SDK / developer guide

Java client

Java client · TA
目標讀者 TAJVM 應用工程師
官方文件能力MqttAsyncClient 回呼及同步 MqttClient 包裝。
輸入 → 輸出用戶端設定與操作 → 回呼或同步結果。
執行環境相容 Java 平台及選定 Maven 發行套件。
本站選型評估須明確選 MQTT v3／v5 套件；發行版與 snapshot 儲存庫不同。
本站建議驗證記錄套件／版本並核对失敗回呼、斷線及重連。
官方文件 · Java client ↗
09

API / SDK / developer guide

Go MQTT 3 client

Go MQTT 3 client · TA
目標讀者 TAGo 服務工程師
官方文件能力非同步 MQTT 3.1／3.1.1 發布及訂閱。
輸入 → 輸出連線選項及發布 → 完成 token 與錯誤。
執行環境固定 Go 模組、broker 及選定 TCP／WebSocket 傳輸。
本站選型評估此儲存庫不是另一套 MQTT 5 Go 用戶端。
本站建議驗證等待 token 完成並檢查 Error，不可認定非同步提交即成功。
官方文件 · Go MQTT 3 client ↗
10

API / SDK / developer guide

Browser JavaScript client

Browser JavaScript client · TA
目標讀者 TA網頁遙測介面工程師
官方文件能力透過 WebSocket 建立瀏覽器 MQTT 連線。
輸入 → 輸出WebSocket broker 端點及訂閱 → 收件／失聯回呼。
執行環境支援 WebSocket 的瀏覽器與 broker 或閘道。
本站選型評估僅有原始 MQTT TCP listener 不足；命名空間因函式庫版本而異。
本站建議驗證固定分發腳本版本並核對失聯處理；不可嵌入高權限 broker 密密碼。
官方文件 · Browser JavaScript client ↗

Official documentation

Official documentation · 補充引用分析
TA工程師與技術產品負責人
本站驗證建議實作前固定版本並依目標環境核對支援條件。
官方文件 · Official documentation ↗

04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE

實作前先看懂預期結果

MQTT 遙測契約示意；未連線 broker 或操作裝置。

示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出

關聯遙測收件成功

預期行為 — 示意，尚未執行
輸入示意 QoS 1 事件 evt-001 位於 demo/line1；有相符訂閱收件。
預期結果status=ok；protocol_ack=true；application_received=true。
驗收條件主題、應用事件 ID 及內容一致；不宣稱實體動作完成。

有效靜默觀測

預期行為 — 示意，尚未執行
輸入訂閱獲准且迴圈健康；示意 10 秒有限時段內零訊息。
預期結果status=empty；received_count=0；window_complete=true。
驗收條件無訊息結果不可混淆為空內容或訂閱失敗。

連線遭拒

預期行為 — 示意，尚未執行
輸入CONNACK 原因指出授權遭拒。
預期結果status=error；stage=connect；不宣稱送達。
驗收條件保留原因並遮蔽憑證；不可僅憑 TCP 連線宣告成功。

發布中斷

預期行為 — 示意，尚未執行
輸入Python 程序在發布完成前重啟；事件僅由建議應用 outbox 保存。
預期結果status=pending；delivery=unknown；replay_requires_deduplication=true。
驗收條件依應用事件 ID 核對；MQTT QoS 不代表業務層恰一次處理。

將預期結果對應至你的應用

將實際執行環境回應對應至此建議應用契約。所有數值皆為示意，不含憑證或真實執行。

預期輸出 JSON — 示意，非實測 · EclipsePaho-expected-results.json
{
  "schema_version": "1.0.0",
  "example": true,
  "provider": "Eclipse Paho",
  "status": "ok",
  "input_id": "sample-001",
  "data": {
    "topic": "demo/line1",
    "event_id": "evt-001",
    "qos": 1,
    "protocol_ack": true,
    "application_received": true,
    "physical_action_verified": false
  },
  "error": null,
  "verification": "illustrative-only;not-provider-response"
}
下載規格、範例與驗收計畫
工程交接 — 本站建議契約與驗收門檻
狀態語意有效空結果與錯誤不同；等待中的工作不可提前顯示成功。
證據記錄服務與 SDK 版本、請求識別、設定及回應映射。此處未執行或量測效能。
建議驗收以授權代表樣本測試前，先約定數值誤差與負載目標。

開發評估

設備遙測訂閱器

開發構想規格・串接尚未實測

接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。

可先做小原型

確認存取後，用少量真實樣本測試一個有文件的操作。此為開發判斷，不是交期估算。

原型輸入規劃
測試設備或模擬器、訊號對照表與明確單位。
原型交付規劃
附時間、資料新鮮度、單位與連線狀態的設備數值。
驗收條件
對照來源驗證比例與時間；設備斷線時不得顯示正常。
依賴條件
閘道或服務帳號、設備資料結構與測試環境。

開發順序

  1. 確認 Eclipse Paho 的存取、授權與支援版本。
  2. 準備上述樣本，針對「設備遙測訂閱器」先實作一個有官方文件的操作。
  3. 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
  4. 通過驗收條件後，再估算擴展投入與客戶交付。

如何驗證需求

記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。

本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。

相關產品

ThingsBoard REST API設備遙測資料看板AWS IoT Core API連網設備登錄工具Azure IoT Hub REST API設備狀態工作台AWS IoT SiteWise API機台資產資料檢視器AWS IoT Greengrass API邊緣軟體部署追蹤器Eclipse Ditto HTTP API設備狀態孿生原型