Mosquitto Websocket 不能連接，解決過程小記 新安裝完系統，啟用 Mosquitto 的 Websocket 功能後，MQTTX 客戶端 一直無法連接。問題困擾了幾天，中途數次放棄，最終完美解決。記錄下解決問題的過程和思路，一來記錄下問題解決方案；二來記錄下解決的過程與思路，總結一 ...
Mosquitto Websocket 不能連接，解決過程小記
新安裝完系統，啟用 Mosquitto 的 Websocket 功能後，MQTTX 客戶端 一直無法連接。問題困擾了幾天，中途數次放棄，最終完美解決。記錄下解決問題的過程和思路，一來記錄下問題解決方案；二來記錄下解決的過程與思路，總結一般解決問題的方法。
問題
安裝好 Mosquitto, 配置中啟用 “允許匿名連接”及配置好 Websocket 監控項，啟動服務。使用 MQTTX 客戶端，mqtt使用mqtt協議能連接上，但是使用 ws 協議無論怎麼設置參數都連接不上。
allow_anonymous true
listener 1883
listener 9001
protocol websockets
解決過程
-
覺得是配置問題，於是百度websocket配置並做各種修改。
- 按網上修改配置為以下配置無果
port 1883 listener 9001 protocol websockets- 修改為以下，無果
listener 1883 protocol mqtt listener 9001 protocol websockets- 修改為以下，無果
listener 1883/0.0.0.0 protocol mqtt listener 9001/0.0.0.0 protocol websockets- 修改為以下，無果
listener 1883 0.0.0.0 protocol mqtt listener 9001 0.0.0.0 protocol websockets學到如下知識
-
修改配置後，重啟服務，配置才能生效
-
修改配置後，服務不能重啟，說明配置項有錯誤
-
儘量使用 listener 替代 port
-
必須使用 protocol websock 才能啟用 websock 不配置的話預設為mqtt協議
-
listener 除埠外，可以配置主機名或ip地址，預設只監聽本地迴環。
-
監聽所有 IP(迴環 區域網IP 外網 或 多網卡多IP) 可以使用 0.0.0.0
-
listener 埠和IP之間，使用 空格 或 / 都可以，但後續發現 空格是標準；/ 有時會導致配置無效
各種修改無效之後，放棄Websocket功能，安裝其它軟體完善系統
-
開啟日誌，查看websocket是否正常
後來看到配置文件有日誌配置項，就想著讓 Mosquitto 列印出運行日誌，看看有什麼異常之類的。意外的是，日誌里明確記錄到啟動了websock，埠號也與配置一致，並且沒有任何異常記錄。再次擱置。
#設置日誌為文件類型，並寫入指定文件，必須為絕對路徑，路徑符號為\\或\ss log_dest file C:\Program Files\mosquitto\logs\info.log # 註意 路徑要存在，日誌文件會自動生成 #記錄日誌的級別 log_type information #說明，關於日誌。要先查看安裝目錄下的 README-windows.txt 文件，裡面有關於類型限制與許可權相關的內容 -
懷疑是不是客戶端的問題，所以找了其它幾個客戶端
MQTT Box、MQTT Explorer、MQTTnetApp、MQTT X 均不能連接。但是意外的發現，使用EMQX 服務的web管理頁面中的"工具-> Websocket"可以連接。
猜想，是不是MQTT X的bug，於是跑到 MQTT X 開源項目中，提了個[問題]([Bug] 連接 WebSocket 錯誤 · Issue #939 · emqx/MQTTX (github.com)) ，驚喜的是，第2天就收到回覆，並且確認是個bug，承諾會修複。
問題依舊沒有解決
-
系統搞完之後，想著放棄之前再努力一次
猜想，是不是和操作系統(新系統是(windwos 11)啥的有關。啟動之前全新安裝的win10虛擬機。在win10虛擬機，試過之後，失望的是問題依舊。
-
看到希望
依然不死心，突然的想到，會不會是 Mosquitto自身的版本問題。
首先去官網（後面看到安裝目錄里也有）版本變更記錄里找，可惜沒有找到什麼有用的，再次失望。
又想，既然有了虛擬機環境，就一個版本一個版本的，試試。雖然笨了點，也用不了多長時間。測試結果
mosquitto版本 MQTTX[1.7.3] MQTTnetApp[1.3.0] MQTT-Explorer[0.4.0] 1.6.9 能連接 能連接 能連接 2.0.0 不能 能 能 2.0.8 能 能 能 2.0.9 能 能 能 2.0.10 能 能 能 2.0.11 能 能 能 2.0.12 不能 不能 不能 2.0.13 不能 不能 不能 2.0.14(當前最新) 不能 不能 不能 看來，還真是版本的問題。起碼可以降級到2.0.11版使用。
-
完美解決問題
回退版本的方法，還是感到美中不足。
猜想，新版本不可能不支持老功能，並且已經連續三個版本了，簡單bug的話，應該已經修複了。可能是配置什麼的，變更了沒有記錄，websocket用的人比較少。
百度不到，官網沒有。既然在開源軟體，難道只能去看源代碼！也不知道是啥語言寫的。去看看。
查看源代碼庫時，眼前一亮，看到 issues，怎麼把這個忘記了。去搜索了下 websocket ，再次驚喜的發現，有幾項相關的，
看了下，真的是有問有答有解決。完美解決。
Anonymous setting for websockets is being ignored · Issue #2459
Can't access using websockets running on Windows · Issue #2425
Arm executable 2.0.12 broken · Issue #2398
後續發現 Stack Overflow 上也有人提出過，Mosquitto no websocket connection since version 02.0.12
原因：2.0.12及以上版本，配置websocket時，必須添加socket_domain配置項，來指定是 ipv4 還是 ipv6
# 完美解決方案 # mqtt 協議配置，分為IP4和IP6兩種，當前可以只配置啟用一種 listener 1883 0.0.0.0 socket_domain ipv4 protocol mqtt listener 1883 :: socket_domain ipv6 protocol mqtt # webscoket 協議配置，分為IP4和IP6兩種，當前可以只配置啟用一種 listener 9001 0.0.0.0 protocol websockets socket_domain ipv4 listener 9001 :: protocol websockets socket_domain ipv4 -
總結
- 解決問題就是多角度排查事件，轉角可以是碰到愛情，更可能是柳暗花明。堅持多想想辦法。
- 開源軟體要選擇用戶量大的，維護時間長的，最好是一直在維護的。這樣出了問題，很大可能已經有人遇到並解決了。
- 最重要 有問題不能先看百度或只看百度
- 一看 軟體說明文檔
- 二 看 官網文檔及變更說明
- 三看 源代碼庫
- 四看 專業網站 Stack Overflow 、微軟文檔、博客園等
- 感謝開源維護者的努力
-
後記
