## 什麼是 MQTT 保留訊息？

釋出者釋出訊息時，如果 Retained 標記被設定為 true，則該訊息即是 MQTT 中的保留訊息（Retained Message）。MQTT 伺服器會為每個主題儲存最新一條保留訊息，以方便訊息釋出後才上線的客戶端在訂閱主題時仍可以接收到該訊息。

如下圖，當客戶端訂閱主題時，如果服務端存在該主題匹配的保留訊息，則該保留訊息將被立即傳送給該客戶端。

![MQTT 保留訊息 圖1](C:\Users\DELL\Desktop\1027技術號三圖片\MQTT 保留訊息 圖1.png)

## 何時使用 MQTT 保留訊息？

釋出訂閱模式雖然能讓訊息的釋出者與訂閱者充分解耦，但也存在一個缺點，即訂閱者無法主動向釋出者請求訊息。訂閱者何時收到訊息完全依賴於釋出者何時釋出訊息，這在某些場景中就產生了不便。

藉助保留訊息，新的訂閱者能夠立即獲取最近的狀態，而不需要等待無法預期的時間，例如：

- 智慧家居裝置的狀態只有在變更時才會上報，但是控制端需要在上線後就能獲取到裝置的狀態；
- 感測器上報資料的間隔太長，但是訂閱者需要在訂閱後立即獲取到最新的資料；
- 感測器的版本號、序列號等不會經常變更的屬性，可在上線後釋出一條保留訊息告知後續的所有訂閱者。

## MQTT 保留訊息的使用

若要使用 MQTT 保留訊息，只需在訊息釋出時將 Retained 狀態設定為 true 即可。接下來我們以開源的跨平臺 [MQTT 5.0 桌面客戶端工具 - MQTT X](https://mqttx.app/zh) 為例，演示如何使用 MQTT 保留訊息。

開啟 MQTT X 後如下所示，需點選 `New Connection` 按鈕建立一個 MQTT 連線。

![建立 MQTT 連線 1 圖2](C:\Users\DELL\Desktop\1027技術號三圖片\建立 MQTT 連線 1 圖2.png)

建立頁面如下，我們只需填寫一個連線名稱（Name），其他引數保持預設。Host 將預設為 EMQX Cloud 提供的[公共 MQTT 伺服器](https://www.emqx.com/zh/mqtt/public-mqtt5-broker)。連線引數填寫完成後，點選右上角的 `Connect` 按鈕建立 MQTT 連線。

![建立 MQTT 連線 2 圖3](C:\Users\DELL\Desktop\1027技術號三圖片\建立 MQTT 連線 2 圖3.png)

連線成功後將會看到連線名稱旁邊的狀態為綠色。然後我們在右下角訊息輸入框向主題 `sensor/t1` 傳送一條普通的訊息。

![MQTT 連線成功 圖4](C:\Users\DELL\Desktop\1027技術號三圖片\MQTT 連線成功 圖4.png)

接下來我們選中右下角的 Retain 標記，並向主題 `sensor/t2` 傳送兩條保留訊息。

![傳送 MQTT 保留訊息 圖5](C:\Users\DELL\Desktop\1027技術號三圖片\傳送 MQTT 保留訊息 圖5.png)

然後點選頁面中間的 `New Subscription` 按鈕建立訂閱。
[![6](http://img.blog.itpub.net/blog/2022/10/27/6edf708e4dc348a6.png?x-oss-process=style/bb "6")](https://www.emqx.com/zh/blog/mqtt5-features-retain-message "6")

如下，我們訂閱萬用字元主題 `sensor/+`，該萬用字元主題將會匹配主題 `sensor/t1` 及 `sensor/t2`。

> 關於萬用字元主題的更多細節，請檢視部落格[透過案例理解 MQTT 主題與萬用字元](https://www.emqx.com/zh/blog/advanced-features-of-mqtt-topics)。
[![7](http://img.blog.itpub.net/blog/2022/10/27/2e7066572ef155a3.png?x-oss-process=style/bb "7")](https://www.emqx.com/zh/blog/mqtt5-features-retain-message "7")

最後，我們將會看到該訂閱能成功收到第二條保留訊息，`sensor/t1` 的普通訊息及 `sensor/t2` 的第一條保留訊息都未收到。可見 MQTT 伺服器只會為每個主題儲存最新一條保留訊息。
[![8](http://img.blog.itpub.net/blog/2022/10/27/46cc87dc5ff63de7.png?x-oss-process=style/bb "8")](https://www.emqx.com/zh/blog/mqtt5-features-retain-message "8")

## 關於 MQTT 保留訊息的 Q&A

### 如何判斷一條訊息是否是保留訊息？

當客戶端訂閱了有保留訊息的主題後，即會收到該主題的保留訊息，可透過訊息中的保留標誌位判斷是否是保留訊息。需要注意的是，在保留訊息釋出前訂閱主題，將不會收到保留訊息。**需要待保留訊息釋出後，重新訂閱該主題，才會收到保留訊息。**

如下圖，我們先訂閱主題 `sensor/t2`，然後向該主題釋出一條保留訊息，該訂閱會立即收到一條訊息，但是該訊息並不是保留訊息。當我們刪除該訂閱，再次重新訂閱 `sensor/t2` 主題時，立即收到了剛剛釋出的保留訊息。
[![9](http://img.blog.itpub.net/blog/2022/10/27/d864ae9f9787545c.png?x-oss-process=style/bb "9")](https://www.emqx.com/zh/blog/mqtt5-features-retain-message "9")

### 保留訊息將儲存多久？如何刪除？

伺服器只會為每個主題儲存最新一條保留訊息，保留訊息的儲存時間與伺服器的設定有關。若伺服器設定保留訊息儲存在記憶體，則 MQTT 伺服器重啟後訊息即會丟失；若儲存在磁碟，則伺服器重啟後保留訊息仍然存在。

保留訊息雖然儲存在服務端中，但它並不屬於會話的一部分。也就是說，即便釋出這個保留訊息的會話已結束，保留訊息也不會被刪除。刪除保留訊息有以下幾種方式：

- 客戶端往某個主題傳送一個 Payload 為空的保留訊息，服務端就會刪除這個主題下的保留訊息；
- 在 MQTT 伺服器上刪除，比如 EMQX MQTT 伺服器提供了在 Dashboard 上刪除保留訊息的功能；
- MQTT 5.0 新增了訊息過期間隔屬性，釋出時可使用該屬性設定訊息的過期時間，不管訊息是否為保留訊息，都將會在過期時間後自動被刪除。

## EMQX 中的 MQTT 保留訊息

[EMQX](https://www.emqx.com/zh/products/emqx) 是一款全球下載量超千萬的大規模分散式物聯網 MQTT 伺服器，於 2013 年在 GitHub 釋出開源版本。

不久前，[EMQX 釋出了 5.0 版本](https://www.emqx.com/zh/blog/emqx-v-5-0-released)，該版本透過一個 23 節點的叢集達成了 1 億 MQTT 連線+每秒 100 萬訊息吞吐，這使得 EMQX 5.0 成為目前為止全球最具擴充套件性的 MQTT 伺服器。

EMQX 5.0 支援在內建的 [Dashboard](https://www.emqx.com/zh/blog/an-easy-to-use-and-observable-mqtt-dashboard) 中檢視、設定保留訊息。感興趣的讀者可透過如下 Docker 命令安裝 EMQX 5.0 開源版進行體驗。

```apache
docker run -d --name emqx -p 1883:1883 -p 8083:8083 -p 8084:8084 -p 8883:8883 -p 18083:18083 emqx/emqx:latest
```

EMQX 安裝成功後，使用瀏覽器訪問 `http://127.0.0.1:18083/` 即可體驗 EMQX 5.0 全新 Dashboard。

> 預設使用者名稱為 admin，密碼為 public

登入成功後，可在左側選單 `System -> Settings` 中修改顯示語言為中文。如下圖，可點選`功能配置->MQTT` 選單檢視已保留的訊息列表，同時也可以檢視保留訊息的 Payload 或者刪除某條保留訊息。
[![10](http://img.blog.itpub.net/blog/2022/10/27/49df372368d8d390.png?x-oss-process=style/bb "10")](https://www.emqx.com/zh/blog/mqtt5-features-retain-message "10")

點選保留訊息下的`設定`選單，可看到 EMQX 支援在 Dashboard 中設定保留訊息的儲存型別（記憶體或磁碟）、最大保留訊息數、保留訊息有效期等引數，點選儲存後所有更改將會立即生效。
[![11](http://img.blog.itpub.net/blog/2022/10/27/4a58dee7d0aac392.png?x-oss-process=style/bb "11")](https://www.emqx.com/zh/blog/mqtt5-features-retain-message "11")

## 結語

本文對 MQTT 保留訊息進行了介紹及使用演示，使用者可以參考本文更好地利用 MQTT 保留訊息解決訂閱後無法立即獲取最近資料的問題。除此之外，MQTT 協議還具備更多實用特性，讀者可檢視 EMQ 提供的 [MQTT 入門與進階](https://www.emqx.com/zh/mqtt)系列文章進行深入瞭解，探索 MQTT 的更多高階應用，開啟 MQTT 應用及服務開發。

>版權宣告： 本文為 EMQ 原創，轉載請註明出處。
>
>原文連結：[https://www.emqx.com/zh/blog/mqtt5-features-retain-message](https://www.emqx.com/zh/blog/mqtt5-features-retain-message)

MQTT 保留訊息是什麼？如何使用？

相關文章