3.4 PUBACK –发布确认 Publish acknowledgement

PUBACK报文是对QoS 1等级的PUBLISH报文的响应。

3.4.1 PUBACK 固定报头 PUBACK Fixed Header

图 3-10 - PUBACK报文固定报头 PUBACK packet Fixed Header
Bit 7 6 5 4 3 2 1 0
byte 1 MQTT报文类型 (4) 保留位
0 1 0 0 0 0 0 0
byte 2… 剩余长度
0 1 0 0 0 0 0 0

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

3.4.2 PUBACK 可变报头 PUBACK Variable Header

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

图 3-11 – PUBACK报文可变报头
Bit 7 6 5 4 3 2 1 0
byte 1 报文标识符 MSB
byte 2 报文标识符 LSB
byte 3 PUBACK原因码
byte 4 属性长度 LSB

3.4.2.1 PUBACK 原因码 PUBACK Reason Code

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

表 3-4 – PUBACK原因码 PUBACK Reason Codes
值 16进制 原因码名称 说明
0 0x00 成功 消息被接收。QoS为1的消息已发布。
16 0x10 无匹配的订阅者 消息被接收，但没有订阅者。只有服务端会发送此原因码。如果服务端得知没有匹配的订阅者，服务端可以使用此原因码代替0x00（成功）。
128 0x80 未指明的错误 接收端不接受此消息，且不愿意透露错误原因或没有适用的原因码。
131 0x83 实现特定错误 PUBLISH报文有效，但不被接收端所接受。
135 0x87 未授权 PUBLISH报文未授权。
144 0x90 主题名无效 主题名格式正确，但未被客户端或服务端所接受。
145 0x91 报文标识符被占用 报文标识符已被占用。可能表明客户端和服务端之间的会话状态不匹配。
151 0x97 超出配额 已超出实现限制或管理限制。
153 0x99 载荷格式无效 载荷格式与载荷格式指示符不匹配。

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

3.4.2.2 PUBACK 属性 PUBACK Properties

3.4.2.2.1 属性长度 Property Length

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

3.4.2.2.2 原因字符串 Reason String

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

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

3.4.2.2.3 用户属性 User Property

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

3.4.3 PUBACK 载荷 PUBACK Payload

PUBACK报文没有有效载荷。

3.4.4 动作

描述见4.3.2节。

第三章目录 MQTT控制报文

项目主页