3.5 PUBREC – 发布已接收（QoS 2，第一步）

PUBREC报文是对QoS等级2的PUBLISH报文的响应。它是QoS 2等级协议交换的第二个报文。

3.5.1 PUBREC 固定报头 PUBREC Fixed Header

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

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

3.5.2 PUBREC 可变报头 PUBREC Variable Header

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

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

3.5.2.1 PUBREC 原因码 PUBREC Reason Code

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

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

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

3.5.2.2 PUBREC 属性 PUBREC Properties

3.5.2.2.1 属性长度 Property Length

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

3.5.2.2.2 原因字符串 Reason String

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

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

3.5.2.2.3 用户属性 User Property

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

3.5.3 有效载荷 PUBREC Payload

PUBREC报文没有有效载荷。

3.5.4 动作 PUBREC Actions

描述见 4.3.3节。

第三章目录 MQTT控制报文

项目主页