0304-PUBACK.md

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控制报文

• 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协议草案中文版