MQTT-3.1.1-CN 1
MQTT 协议 3.1.1 中文版
OASIS 标准
2014 年 10 月 29 日
规范链接
当前版本：
http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.doc (Authoritative)
http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html
http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.pdf
以前的版本：
http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/cos01/mqtt-v3.1.1-cos01.doc (Authoritative)
http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/cos01/mqtt-v3.1.1-cos01.html
http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/cos01/mqtt-v3.1.1-cos01.pdf
最新版本：
http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/mqtt-v3.1.1.doc (Authoritative)
http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/mqtt-v3.1.1.html
http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/mqtt-v3.1.1.pdf
技术委员会：
结构化信息标准促进组织 MQTT 技术委员会
主席：
拉斐尔·J·科恩 (raphael.cohn@stormmq.com), 个人
理查德·J·科彭 (coppen@uk.ibm.com), IBM
编辑：
安德鲁·班克斯 (Andrew_Banks@uk.ibm.com), IBM
拉胡尔·吉普塔 (rahul.gupta@us.ibm.com), IBM
相关文档：
本规范与此有关：
MQTT 和 NIST 网络安全框架 1.0 版。 编辑是杰夫·布朗和路易·菲利普·拉穆勒。最新版本：
http://docs.oasis-open.org/mqtt/mqtt-nist-cybersecurity/v1.0/mqtt-nist-cybersecurity-v1.0.html.
摘要：
MQTT 是一个客户端服务端架构的发布/订阅模式的消息传输协议。它的设计思想是轻巧、开放、
简单、规范，因此易于实现。这些特点使得它对很多场景来说都是很好的选择，包括受限的环境如
机器与机器的通信（M2M）以及物联网环境（IoT），这些场景要求很小的代码封装或者网络带宽
非常昂贵。
本协议运行在 TCP/IP，或其它提供了有序、可靠、双向连接的网络连接上。它有以下特点：
使用发布/订阅消息模式，提供了一对多的消息分发和应用之间的解耦。
消息传输不需要知道负载内容。
提供三种等级的服务质量：.
MQTT-3.1.1-CN 2
“最多一次”，尽操作环境所能提供的最大努力分发消息。消息可能会丢失。例如，这个
等级可用于环境传感器数据，单次的数据丢失没关系，因为不久之后会再次发送。
“至少一次”，保证消息可以到达，但是可能会重复。
“仅一次”，保证消息只到达一次。例如，这个等级可用在一个计费系统中，这里如果
消息重复或丢失会导致不正确的收费。
很小的传输消耗和协议数据交换，最大限度减少网络流量
异常连接断开发生时，能通知到相关各方。
状态：
本文档最后由 OASIS 成员在上面标示的日期最终修订或批准。批准的级别也在上面列出了。如果
要查看本文档最新的修订版请检查上面的
最新版本
位置。技术委员会产生的其它修订版和其它技
术文档都列在这里：https://www.oasis-
open.org/committees/tc_home.php?wg_abbrev=mqtt#technical 。
技术委员会成员对本规范的评论应该发送到技术委员会的邮件列表。其他人应该发送评论到技术委
员会的公共评论列表，方法是点击技术委员会网站的 发送评论 按钮，网页地址是
https://www.oasis-open.org/committees/mqtt/ 。
关于实现本规范必不可少的任何专利是否已公开，以及其它的专利许可条款相关的信息， 请参考技
术委员会网站的知识产权部分（(https://www.oasis-open.org/committees/mqtt/ipr.php）。
引用格式：
引用此规范时应该使用下面的引文格式：
[mqtt-v3.1.1]
MQTT Version 3.1.1. Edited by Andrew Banks and Rahul Gupta. 29 October 2014. OASIS
Standard. http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html. Latest version:
http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/mqtt-v3.1.1.html.
MQTT-3.1.1-CN 4
目录
1 概述 ...........................................................................................................................................8
1.1 MQTT 协议的组织结构...............................................................................................................8
1.2 术语 .........................................................................................................................................8
1.3 规范引用...................................................................................................................................9
1.4 非规范引用 .............................................................................................................................10
1.5 数据表示.................................................................................................................................12
1.5.1 二进制位 ..........................................................................................................................12
1.5.2 整数数值 ..........................................................................................................................12
1.5.3 UTF-8 编码字符串 ............................................................................................................12
1.6 编辑约定.................................................................................................................................13
2 MQTT 控制报文格式 .................................................................................................................14
2.1 MQTT 控制报文的结构.............................................................................................................14
2.2 固定报头.................................................................................................................................14
2.2.1 MQTT 控制报文的类型 ......................................................................................................14
2.2.2 标志.................................................................................................................................15
2.2.3 剩余长度 ..........................................................................................................................16
2.3 可变报头.................................................................................................................................17
2.3.1 报文标识符.......................................................................................................................17
2.4 有效载荷.................................................................................................................................19
3 MQTT 控制报文 ........................................................................................................................20
3.1 CONNECT – 连接服务端 .........................................................................................................20
3.1.1 固定报头 ..........................................................................................................................20
3.1.2 可变报头 ..........................................................................................................................20
3.1.3 有效载荷 ..........................................................................................................................26
3.1.4 响应.................................................................................................................................27
3.2 CONNACK – 确认连接请求......................................................................................................28
3.2.1 固定报头 ..........................................................................................................................28
3.2.2 可变报头 ..........................................................................................................................28
3.2.3 有效载荷 ..........................................................................................................................30
3.3 PUBLISH – 发布消息...............................................................................................................30
3.3.1 固定报头 ..........................................................................................................................30
3.3.2 可变报头 ..........................................................................................................................32
3.3.3 有效载荷 ..........................................................................................................................33
3.3.4 响应.................................................................................................................................33
3.3.5 动作.................................................................................................................................33
3.4 PUBACK –发布确认 ................................................................................................................33
3.4.1 固定报头 ..........................................................................................................................34
3.4.2 可变报头 ..........................................................................................................................34
3.4.3 有效载荷 ..........................................................................................................................34
MQTT-3.1.1-CN 5
3.4.4 动作.................................................................................................................................34
3.5 PUBREC – 发布收到（QoS 2，第一步）..................................................................................34
3.5.1 固定报头 ..........................................................................................................................34
3.5.2 可变报头 ..........................................................................................................................35
3.5.3 有效载荷 ..........................................................................................................................35
3.5.4 动作.................................................................................................................................35
3.6 PUBREL – 发布释放（QoS 2，第二步） ..................................................................................35
3.6.1 固定报头 ..........................................................................................................................35
3.6.2 可变报头 ..........................................................................................................................36
3.6.3 有效载荷 ..........................................................................................................................36
3.6.4 动作.................................................................................................................................36
3.7 PUBCOMP – 发布完成（QoS 2，第三步）...............................................................................36
3.7.1 固定报头 ..........................................................................................................................36
3.7.2 可变报头 ..........................................................................................................................36
3.7.3 有效载荷 ..........................................................................................................................37
3.7.4 动作.................................................................................................................................37
3.8 SUBSCRIBE - 订阅主题 ..........................................................................................................37
3.8.1 固定报头 ..........................................................................................................................37
3.8.2 可变报头 ..........................................................................................................................37
3.8.3 有效载荷 ..........................................................................................................................38
3.8.4 响应.................................................................................................................................39
3.9 SUBACK – 订阅确认 ...............................................................................................................40
3.9.1 固定报头 ..........................................................................................................................40
3.9.2 可变报头 ..........................................................................................................................40
3.9.3 有效载荷 ..........................................................................................................................41
3.10 UNSUBSCRIBE –取消订阅 ....................................................................................................42
3.10.1 固定报头 ........................................................................................................................42
3.10.2 可变报头 ........................................................................................................................42
3.10.3 有效载荷 ........................................................................................................................42
3.10.4 响应 ...............................................................................................................................43
3.11 UNSUBACK – 取消订阅确认 ..................................................................................................44
3.11.1 固定报头 ........................................................................................................................44
3.11.2 可变报头 ........................................................................................................................44
3.11.3 有效载荷 ........................................................................................................................44
3.12 PINGREQ – 心跳请求 ............................................................................................................44
3.12.1 固定报头 ........................................................................................................................45
3.12.2 可变报头 ........................................................................................................................45
3.12.3 有效载荷 ........................................................................................................................45
3.12.4 响应 ...............................................................................................................................45
3.13 PINGRESP – 心跳响应 ..........................................................................................................45
3.13.1 固定报头 ........................................................................................................................45
