文章目录
前言
该报文为控制报文，MQTT5将该报文的传递方向由单向变成双向。
DISCONNECT – 断开连接/断开通知
MQTT3.1.1为断开连接，MQTT5为断开通知
【MQTT 3.1.1】
DISCONNECT报文是客户端发给服务端的最后一个控制报文。表示客户端正常断开连接。
【MQTT 5】
DISCONNECT数据报文是从客户端或服务器发送的最终MQTT控制数据报文。
它指示了网络连接被关闭的原因。 客户端或服务器可以在关闭网络连接之前发送一个DISCONNECT数据报文。 如果网络连接被关闭，而客户端没有首先发送原因码为0x00(正常断开连接)的DISCONNECT数据报文，并且该连接有一个Will消息，则将发布Will消息。
服务器在发送原因代码小于0x80的CONNACK之前，不得发送DISCONNECT 报文。
固定报头
服务端必须验证所有的保留位都被设置为0，如果它们不为0,在MQTT3.1.1中则必须断开连接，在MQTT5中，需要发送包含原因码为0x81(无效报文)的DISCONNECT报文。
剩余长度字段
等于可变报头的长度，编码为变长字节整数
DISCONNECT可变报头(MQTT 5)
MQTT3.1.1 DISCONNECT报文没有可变报头
DISCONNECT报文的可变报头按顺序包含以下字段：断开原因码，属性(Properties)。
断开原因码
可变报头的第1个字节是断开原因码。如果剩余长度小于1，则表示使用原因码0x00(正常断开)。
单字节无符号断开原因码字段如下所示。
断开原因码
客户端或服务端发送DISCONNECT报文时必须使用一种DISCONNECT原因码。如果原因码为0x00(正常断开)且没有属性，原因码和属性长度可以被省略。这种情况下DISCONNECT报文剩余长度为0。
DISCONNECT报文用于指示断开的原因，例如没有确认报文(比如QoS等级0的发布消息)或当客户端或服务端不能继续处理连接。
客户端可以使用这些信息来决定是否重新连接，以及在重新尝试之前应该等待多长时间。
DISCONNECT属性(MQTT5)
属性长度
DISCONNECT报文可变报头中的属性(Properties)的长度被编码为变长字节整数。如果剩余长度小于2，属性长度使用0。
会话过期间隔
17 (0x11)Byte，会话过期间隔(Session Expiry Interval)标识符。
跟随其后的是用四字节整数表示的以秒为单位的会话过期间隔(Session Expiry Interval)。包含多个会话2224 过期间隔将造成协议错误(Protocol Error)。
如果没有设置会话过期间隔，则使用CONNECT报文中的会话过期间隔。
会话过期间隔不能由服务端的DISCONNECT报文发送。
如果CONNECT报文中的会话过期间隔为0，则客户端在DISCONNECT报文中设置非0会话过期间隔将造成协议错误(Protocol Error)。如果服务端收到这种非0会话过期间隔，则不会将其视为有效的DISCONNECT报文。服务端使用包含原因码为0x82(协议错误)的DISCONNECT报文。
原因字符串
31 (0x1F)Byte，原因字符串(Reason String)标识符。
跟随其后的是UTF-8编码字符串表示断开原因。此原因字符串是为诊断而设计的可读字符串，不应该被接收端所解析。
如果此属性使得DISCONNECT报文的长度超出了接收端指定的最大报文长度，则发送端不能发送此属性 。包含多个原因字符串将造成协议错误(Protocol Error)。
用户属性
38 (0x26)Byte，用户属性(User Property)标识符。
跟随其后的是UTF-8字符串键值对。
此属性可用于向客户端提供包括诊断信息在内的附加信息。如果加上用户属性之后的DISCONNECT报文长度超出了接收端指定的最大报文长度，则发送端不能发送此属性 。用户属性允许出现多次，以表示多个名字/值对，且相同的名字可以多次出现。
服务端参考
28 (0x1C)Byte，服务端参考列表(Server Reference)标识符。
跟随其后的是一个UTF-8编码字符串，客户端可以使用它来识别其他要使用的服务端。包含多个服务端参考将造成协议错误(Protocol Error)。
服务端发送包含一个服务端参考和原因码0x9C(使用其他服务端)或0x9D(服务端已移动)的DISCONNECT报文。
DISCONNECT报文可变报头非规范示例
有效载荷
DISCONNECT报文没有有效载荷。
DISCONNECT行为
客户端发送DISCONNECT报文之后：
- 必须关闭网络连接 。
- 不能通过那个网络连接再发送任何控制报文。
服务端在收到DISCONNECT报文时：
MQTT5则为当服务端接收到包含原因码为0x00(成功)的DISCONNECT时，才：
-
必须丢弃任何与当前连接关联的未发布的遗嘱消息，而不发布它。
-
【MQTT3.1.1】如果客户端尚未关闭网络连接，则应关闭网络连接。
-
【MQTT5】接收到DISCONNECT报文时，接收端应该关闭网络连接
