3.7 PUBCOMP – 发布完成（QoS 2，第三步）

3.7 PUBCOMP – 发布完成（QoS 2，第三步）

PUBCOMP报文是对PUBREL报文的响应。它是QoS 2等级协议交换的第四个也是最后一个报文。

3.7.1 PUBCOMP 固定报头 PUBCOMP Fixed Header

图 3-16 – PUBCOMP报文固定报头 PUBCOMP packet Fixed Header

剩余长度字段
表示可变报头的长度，编码为变长字节整数。

3.7.2 PUBCOMP 可变报头 PUBCOMP Variable Header

PUBCOMP报文可变报头按顺序包含以下字段：所确认的PUBREL报文标识符，PUBCOMP原因码，属性。属性（Properties）编码规则如2.2.2节所述。

图 3-17 – PUBCOMP报文可变报头 PUBCOMP packet Variable Header

3.7.2.1 PUBCOMP 原因码 PUBCOMP Reason Codes

可变报头第3字节是PUBCOMP原因码。如果剩余长度为2，则表示使用原因码0x00（成功）。

表 3-7 – PUBCOMP 原因码 PUBCOMP Reason Codes

服务端或客户端发送PUBCOMP报文时必须设置一种PUBCOMP原因码 [MQTT-3.7.2-1]。当原因码为0x00（成功）且没有属性（Properties）时，原因码和属性长度可以被省略。在这种情况下，PUBCOMP剩余长度为2。

3.7.2.2 PUBCOMP 属性 PUBCOMP Properties

3.7.2.2.1 属性长度 Property Length

PUBCOMP报文可变报头中的属性长度被编码为变长字节整数。如果剩余长度小于4，则表示没有属性长度字段。

3.7.2.2.2 原因字符串 Reason String

31 (0x1F) ，原因字符串（Reason String）标识符。
跟随其后的是UTF-8编码的字符串，表示此次响应相关的原因。此原因字符串（Reason String）是为诊断而设计的可读字符串，不应该被接收端所解析。

发送端使用此值向接收端提供附加信息。如果加上原因字符串之后的PUBCOMP报文长度超出了接收端指定的最大报文长度（Maximum Packet Size），则发送端不能发送此原因字符串 [MQTT-3.7.2-2]。包含多个原因字符串将造成协议错误（Protocol Error）。

3.7.2.2.3 用户属性 User Property

38 (0x26) ，用户属性（User Property）标识符。 跟随其后的是UTF-8字符串对。此属性可用于提供诊断信息或关于其他信息。如果加上用户属性之后的PUBCOMP报文长度超出了接收端指定的最大报文长度（Maximum Packet Size），则发送端不能发送此属性 [MQTT-3.7.2-3]。用户属性（User Property）允许出现多次，以表示多个名字/值对，且相同的名字可以多次出现。

3.7.3 PUBCOMP 载荷 PUBCOMP Payload

PUBCOMP报文没有有效载荷。

3.7.4 PUBCOMP 行为 PUBCOMP Actions

描述见4.3.3节。

第三章目录 MQTT控制报文

• 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 – 认证交换

项目主页

• MQTT v5.0协议草案中文版