服务端发送UNSUBACK报文给客户端用于确认收到UNSUBSCRIBE报文。
| Bit | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
|---|---|---|---|---|---|---|---|---|
| byte 1 | MQTT控制报文类型 (11) | 保留位 | ||||||
| 1 | 0 | 1 | 1 | 0 | 0 | 0 | 0 | |
| byte 2 | 剩余长度 | |||||||
剩余长度字段
表示可变报头的长度，对UNSUBACK报文这个值等于2。
UNSUBACK报文可变报头按顺序包含以下字段：所确认的UNSUBSCRIBE报文标识符和属性（ Properties）。属性的编码规则如2.2.2节所述。
| Bit | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
|---|---|---|---|---|---|---|---|---|
| byte 1 | 报文标识符 MSB | |||||||
| byte 2 | 报文标识符 LSB | |||||||
UNSUBACK报文可变报头中的属性的长度被编码为变长字节整数。
31 (0x1F) ，原因字符串（Reason String）标识符。
跟随其后的是UTF-8编码的字符串，表示此次响应相关的原因。此原因字符串（Reason String）是为诊断而设计的可读字符串，不应该被客户端所解析。
服务端使用此值向客户端提供附加信息。如果加上原因字符串之后的UNSUBACK报文长度超出了客户端指定的最大报文长度，则服务端不能发送此原因字符串 [MQTT-3.11.2-1]。包含多个原因字符串将造成协议错误（Protocol Error）。
38 (0x26) ，用户属性（User Property）标识符。
跟随其后的是UTF-8字符串对。此属性可用于向客户端提供包括诊断信息在内的附加信息。如果加上用户属性之后的UNSUBACK报文长度超出了客户端指定的最大报文长度，则服务端不能发送此属性 [MQTT-3.11.2-2]。用户属性（User Property）允许出现多次，以表示多个名字/值对，且相同的名字可以多次出现。
有效载荷包含一个原因码列表。每个原因码对应UNSUBSCRIBE报文中的一个被确认的主题过滤器。UNSUBACK报文中的原因码顺序必须与UNSUBSCRIBE报文中的主题过滤器顺序相匹配 [MQTT-3.11.3-1]。
单字节无符号取消订阅原因码的值如下所示。服务端发送UNSUBACK报文时对于每个收到的主题过滤器，必须使用一个取消订阅原因码 [MQTT-3.11.3-2]。
| 值 | 16进制 | 原因码名称 | 说明 |
|---|---|---|---|
| 0 | 0x00 | 成功 | 订阅已被删除。 |
| 17 | 0x11 | 订阅未发现 | 没有该客户端匹配的主题过滤器被使用。 |
| 128 | 0x80 | 未指定错误 | 取消订阅不能被完成且服务端不愿意透露原因或没有其他适用的原因码。 |
| 131 | 0x83 | 实现指定错误 | UNSUBSCRIBE报文有效，但服务端不接受。 |
| 135 | 0x87 | 未授权 | 客户端未被授权进行取消订阅。 |
| 143 | 0x8F | 主题过滤器无效 | 主题过滤器格式正确，但不被允许。 |
| 145 | 0x91 | 报文标识符已占用 | 指定的报文标识符正在被使用中。 |
非规范评注
对于UNSUBSCRIBE报文中的每个主题过滤器，总有一个对应的原因码。如果原因码不是针对某个特定的主题过滤器（比如0x91（报文标识符已占用）），则对每个主题过滤器都使用此原因码。
- 3.0 Contents – MQTT控制报文
- 3.1 CONNECT – 连接服务端
- 3.2 CONNACK – 确认连接请求
- 3.3 PUBLISH – 发布消息
- 3.4 PUBACK –发布确认
- 3.5 PUBREC – 发布收到（QoS 2，第一步）
- 3.6 PUBREL – 发布释放（QoS 2，第二步）
- 3.7 PUBCOMP – 发布完成（QoS 2，第三步）
- 3.8 SUBSCRIBE - 订阅主题
- 3.9 SUBACK – 订阅确认
- 3.10 UNSUBSCRIBE –取消订阅
- 3.11 UNSUBACK – 取消订阅确认
- 3.12 PINGREQ – 心跳请求
- 3.13 PINGRESP – 心跳响应
- 3.14 DISCONNECT –断开连接
- 3.15 AUTH – 认证交换