遺囑訊息是 MQTT 為那些可能出現 **意外斷線** 的裝置提供的將 **遺囑** 優雅地傳送給第三方的能力。意外斷線包括但不限於：

- 因網路故障或網路波動，裝置在保持連線週期內未能通訊，連線被服務端關閉
- 裝置意外掉電
- 裝置嘗試進行不被允許的操作而被服務端關閉連線，例如訂閱自身許可權以外的主題等

遺囑訊息可以看作是一個簡化版的 PUBLISH 訊息，他也包含 Topic, Payload, QoS  等欄位。遺囑訊息會在裝置與服務端連線時，透過 CONNECT  報文指定，然後在裝置意外斷線時由服務端將該遺囑訊息釋出到連線時指定的遺囑主題（Will Topic）上。這也意味著服務端必須在回覆  CONNACK 之前完成遺囑訊息的儲存，以確保之後任一時刻發生意外斷線的情況，服務端都能保證遺囑訊息被髮布。

以下為遺囑訊息在 MQTT 5.0 和 MQTT 3.1 & 3.1.1 的差異：

|                 | MQTT 5.0 | MQTT 3.1 & 3.1.1 |
| :-------------- | :------- | :--------------- |
| Will Retain     | Yes      | Yes              |
| Will QoS        | Yes      | Yes              |
| Will Flag       | Yes      | Yes              |
| Will Properties | Yes      | **No**           |
| Will Topic      | Yes      | Yes              |
| Will Payload    | Yes      | Yes              |

Will Retain、Will QoS、Will Topic 和 Will Payload 的用處與普通 PUBLISH 報文基本一致，這裡不再贅述。

唯一值得一提的是 Will Retain 的使用場景，它是保留訊息與遺囑訊息的結合。如果訂閱該遺囑主題（Will Topic）的客戶端不能保證遺囑訊息釋出時線上，那麼建議為遺囑訊息設定 Will Retain，避免訂閱端錯過遺囑訊息。

Will Flag 通常是 MQTT 協議實現方關心的欄位，它用於標識 CONNECT 報文中是否會包含 Will Properties、Will Topic 等欄位。

最後一個是 MQTT 5.0 新增的 Will Properties 欄位，屬性本身也是 MQTT 5.0 的一個新特性，不同型別的報文有著不同的屬性，例如 CONNECT 報文有會話過期間隔（Session Expiry Interval）、最大報文長度（Maximum Packet Size）等屬性，SUBSCRIBE 報文則有訂閱識別符號（Subscription Identifier）等屬性。

Will Properties 中的訊息過期間隔（Message Expiry Interval）等屬性與 PUBLISH 報文中的用法基本一致，只有一個遺囑延遲間隔（Will Delay Interval）是遺囑訊息特有的屬性。

遺囑延遲間隔顧名思義，就是在連線斷開後延遲一段時間才釋出遺囑訊息。它的一個重要用途就是避免在裝置因網路波動短暫斷開連線，但能夠快速恢復連線繼續提供服務時發出遺囑訊息，並對遺囑訊息訂閱方造成困擾。

需要注意的是，具體延遲多久釋出遺囑訊息，除了遺囑延遲間隔，還受限於會話過期間隔，取決於兩者誰先發生。所以當我們將會話過期間隔設定為 0 時，即會話在網路連線關閉時過期，那麼不管遺囑延遲間隔的值是多少，遺囑訊息都會在網路連線斷開時立即釋出。

### 演示遺囑訊息的使用

接下來我們使用 [EMQ X](https://www.emqx.io/) 和 [MQTT X](https://mqttx.app/) 來演示一下遺囑訊息的實際使用。

為了實現 MQTT 連線被異常斷開的效果，我們需要調整一下 EMQ X 的預設 ACL 規則與相關配置項：

首先在 `etc/acl.conf` 中新增以下 ACL 規則，表示拒絕本機客戶端連線釋出 test 主題。注意需要加在所有預設 ACL 規則之前，以確保這條規則能成功生效：

```prolog
{deny, {ipaddr, "127.0.0.1"}, publish, ["test"]}.
```

然後修改 `etc/emqx.conf` 中 `zone.internal.acl_deny_action` 配置項，將其設定為 ACL 檢查拒絕時斷開客戶端連線：

```ini
zone.internal.acl_deny_action = disconnect
```

完成以上修改後，我們啟動 EMQ X。

接下來，我們在 MQTT X 中新建一個名為 demo 的連線，Host 修改為 localhost，在 Advanced 部分選擇  MQTT Version 為 5.0，並且將 Session Expiry Interval 設定為 10，確保會話不會在遺囑訊息釋出前過期。

![MQTT X 建立連線](http://img.blog.itpub.net/blog/2022/01/20/06c7e12080dc7163.png?x-oss-process=style/bb "MQTT X 建立連線")

然後在 Lass Will and Testament 部分將 Last-Will Topic 設定為 offline，Last-Will Payload 設定為 `I'm offline`，Will Delay Interval (s) 設定為 5。

![Lass Will and Testament](http://img.blog.itpub.net/blog/2022/01/20/04b62f43bc080476.png?x-oss-process=style/bb "Lass Will and Testament")

完成以上設定後，我們點選右上角的 Connect 按鈕以建立連線。

然後我們再建立一個名為 subscriber 的客戶端連線，並訂閱 offline 主題。

![建立 subscriber 客戶端](http://img.blog.itpub.net/blog/2022/01/20/93eccb380df27df3.png?x-oss-process=style/bb "建立 subscriber 客戶端")

接下來我們回到 demo 連線中，釋出一個 Topic 為 test 的任意內容訊息，這時連線會被斷開，耐心等待五秒鐘，我們將看到 subscriber 連線收到了一條內容為 `I‘m offline` 的遺囑訊息。

![釋出訊息](http://img.blog.itpub.net/blog/2022/01/20/e923e261d8755cb3.png?x-oss-process=style/bb "釋出訊息")

### 進階使用場景

這裡介紹一下如何將 Retained 訊息與 Will 訊息結合起來進行使用。

1. 客戶端 A 遺囑訊息內容設定為 `offline`，該遺囑主題與一個普通傳送狀態的主題設定成同一個 `A/status`。
2. 當客戶端 A 連線時，向主題 `A/status` 傳送內容為 `online` 的 Retained 訊息，其它客戶端訂閱主題 `A/status` 的時候，將獲取到 Retained 訊息為 `online`。
3. 當客戶端 A 異常斷開時，系統自動向主題 `A/status` 傳送內容為 `offline` 的訊息，其它訂閱了此主題的客戶端會馬上收到 `offline` 訊息；如果遺囑訊息設定了 Will Retain，那麼此時如果有新的訂閱 `A/status` 主題的客戶端上線，也將獲取到內容為 `offline` 的遺囑訊息。

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

MQTT 遺囑訊息（Will Message）的使用

相關文章