Tema 4 · MQTT:基于发布/订阅的消息传递

Tema 4: Comunicación mediante paso de mensajes — MQTT
逐句对照版 · 讲义 25 页一页不省 · 一句西语 → 一句中文 → 考点解释 · 每页附原页截图
怎么用这份讲义

一、课程封面与内容索引

p.1–p.2
p.1

Portada · 封面

▸ 原页截图 p.1原讲义第 1 页

Sistemas Concurrentes y de Tiempo Real

并发与实时系统(课程名,缩写 SCTR)。

Grado en Ingeniería Telemática

远程通信工程本科(专业名,答题写课程归属时会用到)。

Tema 4: Comunicación mediante paso de mensajes

主题 4:通过消息传递(paso de mensajes)实现的通信。

MQTT

本篇专讲的消息传递协议:MQTT。

标题固定搭配是 comunicación mediante paso de mensajes(靠传递消息来通信)。mediante = 通过、借助,比 por 更书面,抄标题时不要写成 por paso de mensajes。
Tema 4 的两大路线: memoria compartida (前几章)与 paso de mensajes(本章)。前者靠"共享一块地",后者靠"寄信",MQTT 就是寄信体系里最流行的那套邮政系统。
p.2

Índice de contenidos · 目录

▸ 原页截图 p.2原讲义第 2 页

Índice de contenidos

内容索引(目录)。

• Características

特点:MQTT 是什么、解决什么问题(p.3–p.5)。

• Tópicos

Tópicos:主题的层级结构与通配符(p.6–p.8)。

• Probando MQTT

试用 MQTT:两个在线客户端(p.9)。

• Mosquitto MQTT

Mosquitto:自建 bróker 与 C 语言客户端编程(p.13–p.20)。

• MQTT 5

MQTT 5 的新特性(p.23–p.24)。

目录里没单独列、但正文出现的内容:QoS 三级、持久会话、保留消息、遗嘱消息、SSL/TLS 与用户名密码。这些恰是笔试最爱考的点,别因为目录没写就跳过(p.10–p.12、p.21–p.22)。
五个关键词按"是什么 → 怎么命名 → 怎么试 → 怎么搭 → 怎么升级"排列:Características → Tópicos → Probando → Mosquitto → MQTT 5。

二、MQTT 的定位与核心特点

p.3–p.5
p.3

Características · 基本定位

▸ 原页截图 p.3原讲义第 3 页

Message Queue Telemetry Transport

消息队列遥测传输(MQTT 的全称,答题先写全称再写缩写最稳)。

Protocolo creado en 1999. Estándar OASIS

1999 年创建的协议,现为 OASIS 标准。

Versión actual: 5.0 (Mar 2019), 3.1.1 ampliamente usada

当前版本 5.0(2019 年 3 月),而 3.1.1 仍被广泛使用。

https://docs.oasis-open.org/mqtt/mqtt/v5.0/mqtt-v5.0.html

MQTT 5.0 官方规范地址(OASIS 文档库)。

http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/mqtt-v3.1.1.html

MQTT 3.1.1 官方规范地址。

Comunicación Machine-to-Machine (M2M) para IoT

面向物联网(IoT)的机器对机器(M2M)通信。

Simple, ligero y fácil de implementar

简单、ligero、易于实现。

Consume muy poco ancho de banda y puede ser utilizado en la mayoría de los dispositivos empotrados con pocos recursos (CPU, RAM).

占用带宽极小,可用于大多数资源很少(CPU、RAM)的嵌入式设备。

Características

特点(本页标题)。

这一页就是"MQTT 三连问"的标准答案:① 哪年、谁的标准(1999、OASIS);② 干嘛用的(IoT 的 M2M 通信);③ 为什么选它(简单、轻量、省带宽、能在低配嵌入式设备上跑)。三句话答完,分就齐了。
课程用 dispositivos empotrados 表示"嵌入式设备",别写成 embebidos(也能懂,但不是讲义用词)。另外 3.1.1 是"仍广泛使用",不是"当前版本"——当前版本是 5.0。
记数字:1999 出生,5.0 在 2019 年 3 月上线,3.1.1 是老将仍在服役。轻量到什么程度?小到"传感器里的单片机"都带得动。
p.4

Características · 七大特性

▸ 原页截图 p.4原讲义第 4 页

Protocolo Publish/Subscribe

发布/订阅协议。

Modelo uno a muchos y Desacoplamiento de aplicaciones (espacio y tiempo)

一对多模型,以及应用之间的解耦(空间上和时间上)。

Componente intermedio (Broker MQTT, p.ej. Mosquitto)

中间组件(MQTT Broker,例如 Mosquitto)。

https://mosquitto.org/

Mosquitto 官网(后面 p.13 起就用它)。

Ambas características muy útiles para aplicaciones con muchos clientes (escalabilidad)

(发布/订阅与 broker)这两个特性对"客户端数量很多"的应用非常有用,即escalabilidad。

Neutral respecto a los datos (JSON, texto, …)

对数据格式保持中立(JSON、纯文本……都行)。

Se ejecuta sobre TCP/IP

运行在 TCP/IP 之上。

Tres niveles de QoS para el envío de mensajes

发送消息有三个 QoS 等级(详见 p.10)。

Última voluntad, mensajes retenidos, sesiones y seguridad

遗嘱消息、保留消息、会话与安全(详见 p.11–p.12)。

Características

特点(本页标题)。

"¿Qué características tiene MQTT?" 按讲义顺序背 7 条:publish/subscribe、uno a muchos + desacoplamiento、broker intermedio、neutral a los datos、sobre TCP/IP、3 niveles de QoS、última voluntad/retenidos/sesiones/seguridad。答出 5 条即稳,答全 7 条满分。
"Desacoplamiento ... (espacio y tiempo)" 这两个词是考点,不是修辞:espacio = 发布者不需要知道订阅者的地址;tiempo = 双方不必同时在线。答题写 "desacoplamiento en espacio y en tiempo" 最规范。
一句话主线:publish/subscribe + broker = 靠中间人传话,谁也不认识谁。正因为"谁都不认识谁",才能一对多、才能扛住海量客户端。
p.5

Características · 发布/订阅示意图

▸ 原页截图 p.5(图示页)原讲义第 5 页

Los mensajes son publicados en "topics" (tópicos/temas).

消息被发布到 “topics”(西语也写 tópicos / temas,即主题)上。

El contenido de los mensajes puede ser binario, texto plano o JSON

消息内容可以是二进制、纯文本或 JSON。

y los nodos que deseen recibir mensajes deben suscribirse a los tópicos.

而希望接收消息的节点必须订阅这些主题。

Todos son clientes publicadores y/o suscriptores del bróker

所有节点都是该 bróker 的发布者和/或订阅者客户端。

Desacoplamiento entre publicadores/suscriptores (escalabilidad)

发布者与订阅者之间相互解耦(带来可扩展性)。

• Es un protocolo de publicación/suscripción.

它是一种发布/订阅协议。

• Componente intermedio (Bróker MQTT)

(由)中间组件(MQTT 代理)承担转发。

{"temperature":20.0}

图中示例负载:{"temperature":20.0},一个 JSON 键值对,键是温度、值是 20.0。

Características

特点(本页标题)。

看箭头:发布者 → bróker → 订阅者,消息永远不直连。所以发布者不需要知道有几个人在听,订阅者也不需要知道是谁发的——这就是"解耦"在图上长什么样。
经典问法 "¿Quién conoce a quién en MQTT?" 标准答:todos los clientes conocen solo al bróker;los publicadores no conocen a los suscriptores。
邮局类比:寄信人只把信投进邮局窗口,收信人只去邮局取信,两人互不知道对方地址;邮局 = bróker,信封上的分类号 = topic,信纸内容 = payload。
p.6

Tópicos · 层级结构

▸ 原页截图 p.6(图示页)原讲义第 6 页

Los tópicos se representan con cadenas de texto en una estructura jerárquica.

主题用层级结构的文本字符串表示。

Cada nivel comienza con '/’.

每一层以 “/” 开头。(原文表述,见下方陷阱)

Ejeplos

示例(原文拼作 Ejeplos,正确拼写为 Ejemplos)。

building0/floor0/room0/temperature

0 号楼 / 0 层 / 0 号房间 / 温度。

building0/floor0/room1/noise

0 号楼 / 0 层 / 1 号房间 / 噪声。

building0/floor1/room0/noise

0 号楼 / 1 层 / 0 号房间 / 噪声。

右侧树形图的层级:building0 → floor0 / floor1 → room0 / room1;每条从根到叶的路径就是一个主题,页面上出现的节点文字即各层名字。

Los mensajes se publican en tópicos

消息发布到主题上。

Topic + Payload

主题 + 负载(即"往哪儿发" + "发什么")。

El contenido del mensaje puede ser JSON o texto plano

消息内容可以是 JSON 或纯文本。

两处原文硬伤:① Ejeplos → 应为 Ejemplos;② "Cada nivel comienza con '/'" 严格说层级之间用 “/” 分隔,主题开头并不写 “/”(写 building0/floor0/...,不是 /building0/...)。考试按"用 / 分隔层级"理解,别照抄"以 / 开头"。
给一个 topic 要能说出:层级数(4 层)、叶子含义(temperature 是测量量)、能匹配它的订阅(building0/floor0/room0/+ 或 building0/#)。
topic 像文件路径:斜杠是分隔符,不是开头符;topic 大小写敏感、不支持中文歧义写法,考试照抄字符串即可。

三、主题通配符与动手试

p.7–p.9
p.7

Tópicos · 通配符

▸ 原页截图 p.7原讲义第 7 页

Se pueden utilizar comodines para suscribirse a los tópicos

可以使用通配符来订阅主题。

Nivel único: + (pueden ser usados varias veces)

单层通配符:+(可以在一个 filter 里多次使用)。

Múltiples niveles: #

多层通配符:#(吃掉它后面剩下的所有层级)。

Evitar suscripciones a #

应避免订阅 #(会收下整个 bróker 的全部流量)。

订阅 filter匹配的例子不匹配
building0/floor0/room0/+building0/floor0/room0/temperaturebuilding0/floor0/room0/a/b
building0/+/room0/temperaturebuilding0/floor1/room0/temperaturebuilding0/floor1/room1/temperature
building0/#building0/floor0/room0/temperaturebuilding1/floor0/...
两个符号必须分清:+ 只替换一层(且必须独占一层,不能写成 room+);# 替换其余所有层,按规范只能出现在 filter 末尾且只出现一次。考试常让你"写出订阅所有房间温度的 filter"。
原文只说 + "可以多次使用",没提 # 的限制。补一条规范:# 只能放在最后一级(building0/# 合法,building0/#/room0 非法)。写错这条会直接扣分。
+ 是"一层楼",可以连着用好几层(+/+/+);# 是"这层往下全要",所以它只能在句尾收场。
p.8

Ejemplo: Riego en jardines · 花园灌溉

▸ 原页截图 p.8(图示页)原讲义第 8 页

Jardín dividido en varias parcelas, cada parcela con diferentes plantas, árboles y características de riego.

花园被分成若干地块,每块地种着不同的植物、树木,灌溉需求也不同。

Algunos tópicos podrían ser:

可以设计出这样的主题:

jardín/césped/temperatura

花园 / 草坪 / 温度。

jardín/frutales/manzanos/temperatura

花园 / 果树区 / 苹果树 / 温度。

jardín/rosales/humedad

花园 / 玫瑰区 / 湿度。

Parcela · Césped · Frutales · Rosales · etc. · Manzano · Perales

图层级:地块 → 草坪 / 果树 / 玫瑰……;果树 → 苹果树 / 梨树(Manzano = 苹果树,Perales = 梨树)。

sensores · parcelas · plantas

图中三个维度:传感器 / 地块 / 植物——主题就是沿这三个维度切出来的路径。

Estructura jerárquica

层级结构(树根到树叶)。

Humedad · Temperatura

叶子节点上的两种测量量:湿度 / 温度。

jardín/+/+/temperatura

订阅:任意地块、任意植物层的温度。

jardín/#

订阅:花园底下所有主题。

Ejemplo: Riego en jardines

本页标题:示例——花园灌溉。

这页是通配符的"应用题模板"。必会两句:jardín/+/+/temperatura = 所有地块所有植物的温度;jardín/# = 整个花园的全量数据。考试把 jardín 换成 building 也一样做。
注意 jardín/+/+/temperatura 里的两个 + 各占一层:它匹配 jardín/césped/x/temperatura 这类恰好四层的主题,不会匹配三层的 jardín/césped/temperatura。层数必须严格对齐。
把主题当"地址"读:省/市/区/门牌。+ 是"这一级随便",# 是"这一级以下全包"。jardín/+/+/temperatura 读作"花园/随便/随便/温度"。
p.9

Probando MQTT · 在线试用

▸ 原页截图 p.9原讲义第 9 页

Probando MQTT

试用 MQTT(本页标题)。

Servidores públicos para pruebas

用于测试的公共服务器(不用自己装 bróker就能玩)。

http://www.hivemq.com/demos/websocket-client/

HiveMQ 的网页版 WebSocket 客户端:浏览器里直接发布/订阅。

https://mqttx.app/web-client

MQTTX 网页客户端:另一个免安装的在线调试工具。

这两个链接是"五分钟上手"的入口:左边窗口订阅一个主题,右边窗口往同一主题发布,立刻能看到消息回流。URL 不用背,但要知道"MQTT 有公共测试 bróker + 网页客户端"这种玩法,实验报告里可以写。
口头题常问 "¿Cómo puedo probar MQTT rápidamente?" 答:使用公共 bróker(如 broker.hivemq.com)配合网页客户端(HiveMQ WebSocket client / MQTTX web),一个订阅、一个发布即可验证通路。
线上试 = 借别人的邮局;本地装 Mosquitto = 自己开邮局。先用别人的,下一节再自己开(p.13)。

四、QoS、持久会话、保留与遗嘱消息

p.10–p.12
p.10

Calidad de Servicio (QoS) · 三个等级

▸ 原页截图 p.10原讲义第 10 页

MQTT permite especificar 3 niveles de calidad de servicio

MQTT 允许指定 3 个服务质量等级。

Como máximo una vez (0)

最多一次(等级 0)。

Política de mejor esfuerzo. Se pueden perder mensajes

"尽力而为"策略,可能丢消息。

Cuando por ejemplo no pasa nada si se pierde la lectura de un sensor

例如:丢一次传感器读数也无所谓的场合。

Al menos una vez (1)

至少一次(等级 1)。

Se garantiza la llegada

保证到达。

Pueden producirse duplicados

但可能产生重复。

Exactamente una vez (2)

恰好一次(等级 2)。

Los mensajes llegan exactamente una vez

消息恰好到达一次。

El más seguro y más lento

最安全、也最慢。

Calidad de Servicio (QoS)

服务质量(QoS,本页标题)。

QoS西语名称保证代价典型场景
0Como máximo una vez最多一次,可丢最小(无确认)周期性传感器读数
1Al menos una vez至少一次,可能重复中等(PUBACK)告警、不能丢的状态
2Exactamente una vez恰好一次最大(四次握手)计费、不可重复的操作
必背对照:0 = 最多一次 / 1 = 至少一次 / 2 = 恰好一次,中文四字要能秒答。"哪个最安全最慢?" → 2;"哪个可能重复?" → 1;"哪个可能丢?" → 0。三问连考率极高。
QoS 的保证范围是客户端 ↔ bróker 之间(每一跳分别协商),不是端到端。所以"QoS 2 就一定不重复"在"发布者 QoS2 + 订阅者 QoS0"的链路上不成立。这是最经典的扣分点。
三个词按"数量"记:0 最多、1 至少、2 恰好。价格也按这个顺序涨:不要确认 < 要一次确认 < 要四次握手,所以 2 最慢。
p.11

Sesiones persistentes y mensajes retenidos · 持久会话与保留消息

▸ 原页截图 p.11原讲义第 11 页

Se pueden establecer sesiones persistentes entre un cliente y el Broker

可以在客户端与 bróker 之间建立持久会话。

Si hay pérdida de conexión no es necesario volver a suscribirse a todos los tópicos

断线后不必重新订阅所有主题(bróker 记得你订过什么)。

También se guardan mensajes con QoS 1 o 2 no recibidos por el cliente (¿por cuánto tiempo?)

客户端尚未收到的 QoS 1 或 2 消息也会被保存(保存多久?——由会话过期时间决定,MQTT 5 可指定秒数)。

Un mensaje retenido es un mensaje MQTT con el flag "retained" a true

保留消息就是 retained 标志为 true 的 MQTT 消息。

El broker guardará el último mensaje retenido para ese tópico

bróker 会为每个主题保存最后一条保留消息(新的覆盖旧的)。

Cuando el cliente se suscriba, recibirá el mensaje inmediatamente (y podrá saber si es un mensaje retenido)

客户端一订阅就立即收到该消息(并且能判断它是不是保留消息)。

Mecanismo para obtener información inmediata del estado

这是"立即拿到当前状态"的机制(新订阅者不必干等下一次发布)。

Sesiones persistentes y mensajes retenidos

持久会话与保留消息(本页标题)。

必答区分:sesión persistente 保存的是"订阅关系 + 离线期间没送达的 QoS1/2 消息";mensaje retenido 保存的是"该主题最后一条状态",对任何新订阅者立即投递。前者面向"同一个客户端断线重连",后者面向"任何后来的订阅者"。
保留消息每个主题只留最新一条,不是队列;而持久会话里未送达的消息是逐条排队的。把两者都说成"bróker 帮你存消息"就会答糊,一定要写清"存的是一条状态"还是"存的是一串待投递消息"。
持久会话 = 记住"你订过什么";保留消息 = 记住"最后一条状态"。一个管关系,一个管快照。
p.12

Última voluntad y seguridad · 遗嘱消息与安全

▸ 原页截图 p.12原讲义第 12 页

Se puede establecer un mensaje de última voluntad para el caso de desconexiones abruptas con el Broker

可以设置一条遗嘱消息,用于与 bróker 突然断开的情况。

Es un mensaje normal, con tópico y QoS

它是一条普通消息,同样带主题和 QoS。

Se puede establecer un periodo de keep-alive para saber cuándo enviar el mensaje (según el caso, se puede detectar sin tener que esperar el tiempo indicado)

可以设定 keep-alive 周期来判断何时下发该消息(视情况,不必等满整个周期也能检测到掉线)。

Seguridad en MQTT

MQTT 中的安全问题。

El principal problema de la mayoría de los protocolos IoT

这是大多数 IoT 协议的主要问题。

MQTT funciona sobre TCP, por lo que puede utilizar SSL/TLS

MQTT 跑在 TCP 上,因此可以使用 SSL/TLS 加密。

Usuario/Password en la conexión del mensaje

连接时使用用户名/密码认证。

Payload Encriptado

负载加密(应用层再加密一层)。

Última voluntad y seguridad

遗嘱消息与安全(本页标题)。

遗嘱消息三要素必答:① 一条普通消息(topic + payload + QoS);② 触发条件 = 异常断开(keep-alive 超时、网络断、未正常 DISCONNECT);③ 由 bróker 代为发布。正常断开则不发——这三句写全才满分。
安全四条别只写 TLS:SSL/TLS 加密传输 + 用户名/密码认证 + 负载加密 + (实际部署还有)ACL 主题权限。讲义列了前三,答辩时补一句 ACL 会显得更完整。
"我死了也要发最后一条" = última voluntad;"心跳停了就判我死" = keep-alive。二者是配套机制:keep-alive 负责发现死亡,遗嘱负责死亡后通知。

五、Mosquitto:装 bróker 与写 C 客户端

p.13–p.20
p.13

Mosquitto MQTT · 安装与命令行测试

▸ 原页截图 p.13原讲义第 13 页

Mosquitto MQTT

Mosquitto MQTT(本页标题)。

Vamos a usar Mosquitto y su librería de C

我们将使用 Mosquitto 及其 C 语言库。

https://github.com/eclipse-mosquitto/mosquitto

源码仓库(Eclipse 基金会项目)。

https://mosquitto.org/api/files/mosquitto-h.html

C API 参考文档(即 mosquitto.h 的函数说明)。

Lo primero que necesitamos es el bróker

首先需要的是 bróker。

Podemos usar uno público para pruebas o disponer de uno propio

可以用公共的做测试,也可以自备一个。

Para instalar nuestro propio bróker Mosquitto:

安装自己的 Mosquitto bróker:

sudo apt update

刷新软件源索引。

sudo apt install -y mosquitto mosquitto-clients

安装 bróker 本体与命令行客户端(mosquitto-clients 提供 pub/sub 两个命令)。

sudo systemctl enable --now mosquitto

设为开机自启并立即启动(--now = 现在就起)。

Verificamos que está activo:

验证服务处于运行状态:

sudo systemctl status mosquitto

查看服务状态(看到 active (running) 即成功)。

Podemos hacer unas pruebas desde dos terminales diferentes:

可以在两个不同终端里做测试:

mosquitto_sub -h localhost -t test/ejemplo

终端 A 订阅:-h 主机、-t 主题。

mosquitto_pub -h localhost -t test/ejemplo -m "Hola MQTT“

终端 B 发布:-m 后面是消息内容 “Hola MQTT”。

命令行三参数必背:-h(host)、-t(topic)、-m(message,只有 pub 有)。答"如何快速验证 bróker 是否正常"就写:一个终端 mosquitto_sub -h localhost -t test/ejemplo,另一个 mosquitto_pub ... -m "Hola MQTT",订阅端能立刻打印出内容。
原文最后一句的引号写成了 "Hola MQTT“(句尾是开引号),正确应为 "Hola MQTT",属排版笔误,直接复制会报 shell 语法错误。
安装三连:update → install → systemctl enable --now;测试两连:先 sub 后 pub,顺序反了 QoS0 会丢(bróker 不替你留)。
p.14

Mosquitto MQTT · 开发环境与可用 bróker

▸ 原页截图 p.14原讲义第 14 页

Para desarrollar programas en C, tenemos que instalar libmosquitto-dev

用 C 开发程序,需要安装 libmosquitto-dev(开发头文件与库)。

sudo apt install libmosquitto-dev

安装开发包(装了它才有 mosquitto.h)。

Después, tendremos que compilar nuestros programas usando la opción –lmosquitto

之后编译程序时要用 -lmosquitto 选项链接库。

Posibles brokers para utilizar

可以使用的 bróker:

Puerto 1883

端口 1883(MQTT 明文默认端口)。

Localhost (bróker local)

本机(自己装的那个 bróker)。

broker.hivemq.com

HiveMQ 公共测试 bróker。

broker.emqx.io

EMQX 公共测试 bróker。

编译命令模板:gcc -o publisher publisher.c -lmosquitto。-l 在前、库名在后,且链接参数要写在源文件后面(gcc 从左到右解析依赖)。端口记两个:1883 明文、8883 TLS。
原文写的是 –lmosquitto(长破折号 –),真正的参数是 -lmosquitto(短横线 -)。照抄原文的破折号会编译失败——p.20 同样有这个问题。
1883 = "一八八三,明文爱谁看谁看";8883 = "两个 8 一夹,加密了"。开发包叫 libmosquitto-dev,-dev 就是"开发用"。
p.15

Publicador C · 发布回调与 publish 函数

▸ 原页截图 p.15原讲义第 15 页

Publicador C

C 语言发布者(本页标题)。

/* publisher.c —— 发布传感器温度 */
#include <mosquitto.h>

void on_connect(struct mosquitto *mosq, void *obj, int reason_code)
{ printf("on_connect: %s\n", mosquitto_connack_string(reason_code)); }

void on_publish(struct mosquitto *mosq, void *obj, int mid)
{ printf("Message with mid %d has been published.\n", mid); }

void publish_sensor_data(struct mosquitto *mosq)
{
    char payload[20];
    temp = get_temperature();
    snprintf(payload, sizeof(payload), "%d", temp);
    mosquitto_publish(mosq, NULL, TOPIC, strlen(payload),
                      payload, 2, false);
}
原页代码 · Publicador C(p.15)
这段在考什么:publish 的 7 个参数依次是 (句柄, message_id, topic, payloadlen, payload, qos, retain)。这里 NULL = 不关心消息号,2 = QoS 2,false = 不保留。问"如何用 C 发布一条 QoS2 消息"就答这一行。
两处代码瑕疵:① temp 未声明(应为 int temp = get_temperature(); 或 double);② 用 "%d" 格式化温度,而 p.5 的温度是 20.0 这种小数,应改 "%.1f" 并用 double。规范写 snprintf 是对的(防溢出)。
publish 的参数顺序按"身份 → 编号 → 去哪 → 多长 → 什么 → 多稳 → 存不存"记:mosq, mid, topic, len, payload, qos, retain。
p.16

Publicador C · main 与事件循环

▸ 原页截图 p.16原讲义第 16 页

Publicador C

C 语言发布者(本页标题)。

int main(int argc, char *argv[])
{
    struct mosquitto *mosq;
    mosquitto_lib_init();
    mosq = mosquitto_new(NULL, true, NULL);
    mosquitto_connect_callback_set(mosq, on_connect);
    mosquitto_publish_callback_set(mosq, on_publish);
    mosquitto_connect(mosq, BROKER, PORT, 60);
    mosquitto_loop_start(mosq);
    while(1) publish_sensor_data(mosq);
    mosquitto_lib_cleanup();
    return 0;
}
原页代码 · Publicador C(p.16)
初始化流程五步必背:lib_init → new → 登记回调 → connect → loop_start,收尾 lib_cleanup。第 4 个参数 60 是 keep-alive 秒数(对应 p.12 的心跳)。问"MQTT C 程序的基本骨架"就写这五行。
mosquitto_new(NULL, true, NULL) 的第二个参数 true = clean session(干净会话),即不复用持久会话;想用 p.11 的持久会话这里要传 false。这是"概念会背、代码写错"的高发点。
loop_start = 开后台线程跑网络循环(发布者用它,才能边发边收 ACK);loop_forever = 自己阻塞跑循环(订阅者用它,p.19)。两者不要混。
p.17

Suscriptor C · 连接后订阅

▸ 原页截图 p.17原讲义第 17 页

Suscriptor C

C 语言订阅者(本页标题)。

void on_connect(struct mosquitto *mosq, void *obj, int
                reason_code)
{
    printf("on_connect: %s\n",
           mosquitto_connack_string(reason_code));
    mosquitto_subscribe(mosq, NULL, TOPIC, 1);
}

void on_subscribe(struct mosquitto *mosq, void *obj, int mid,
                  int qos_count, const int *granted_qos)
{
    int i;
    for(i=0; i<qos_count; i++){
        printf("on_subscribe: %d:granted qos = %d\n", i,
               granted_qos[i]);
    }
}
原页代码 · Suscriptor C(p.17)
这段在考什么:订阅必须放在 on_connect 回调里,不能在 main 里直接调——因为 TCP 连上不等于 MQTT 已 CONNACK 成功。订阅函数四参:(句柄, mid, topic_filter, qos),末位 1 是请求的 QoS。
granted_qos 是 bróker 批准的 QoS,可能低于你请求的值(bróker 能力受限时)。所以"订阅 QoS1 就一定收 QoS1"是错的,要看 granted_qos。
顺序记牢:conectar → CONNACK(on_connect) → subscribe → SUBACK(on_subscribe) → 收消息(on_message)。回调是"别人叫你",不是"你调别人"。
p.18

Suscriptor C · 消息回调

▸ 原页截图 p.18原讲义第 18 页

Suscriptor C

C 语言订阅者(本页标题)。

void on_message(struct mosquitto *mosq, void *obj,
                const struct mosquitto_message *msg)
{
    printf("%s %d %s\n", msg->topic, msg->qos,
           (char *)msg->payload);
}
原页代码 · Suscriptor C(p.18)
这段在考什么:收到消息时从 struct mosquitto_message 里取三样东西——topic / qos / payload。payload 是 void *,必须强转 (char *) 才能当字符串打印;还可用 msg->payloadlen 取长度(二进制数据必须靠它,不能靠 '\0')。
printf("%s", payload) 只对"以 \0 结尾的文本"安全。若负载是二进制(p.5 明确允许),必须用 fwrite 或按 payloadlen 写,否则会越界或截断。
回调三件套:on_connect 里订阅、on_subscribe 看批准 QoS、on_message 收数据。收数据就盯 topic + qos + payload 三字段。
p.19

Suscriptor C · main 与阻塞循环

▸ 原页截图 p.19原讲义第 19 页

Suscriptor C

C 语言订阅者(本页标题)。

int main(int argc, char *argv[])
{
    struct mosquitto *mosq;
    mosquitto_lib_init();
    mosq = mosquitto_new(NULL, true, NULL);
    mosquitto_connect_callback_set(mosq, on_connect);
    mosquitto_subscribe_callback_set(mosq, on_subscribe);
    mosquitto_message_callback_set(mosq, on_message);
    rc = mosquitto_connect(mosq, BROKER, PORT, 60);
    mosquitto_loop_forever(mosq, -1, 1);
    mosquitto_lib_cleanup();
    return 0;
}
原页代码 · Suscriptor C(p.19)
这段在考什么:订阅者要多登记一个 message callback,然后用 loop_forever 阻塞等消息。三个回调各管一件事:on_connect 里订阅、on_subscribe 收批准结果、on_message 收数据。答"订阅者和发布者的 main 差别在哪"就答这两点。
rc 未声明就使用了——正确写法是 int rc = mosquitto_connect(...);,并且应当检查返回值(非 0 说明连接失败)。原文这段直接编译会报 "rc undeclared",p.21 也有同样问题。
loop_forever = 死等(订阅者,收到消息才动);loop_start = 后台线程(发布者,主线程继续 while(1) 发)。一个阻塞、一个并发,考试爱在这里设陷阱。
p.20

Mosquitto MQTT · 编译与运行

▸ 原页截图 p.20原讲义第 20 页

Compilamos…

编译……

gcc -o publisher publisher.c –lmosquitto

把 publisher.c 编译成可执行文件 publisher,并链接 libmosquitto。

gcc -o subscriber subscriber.c –lmosquitto

同理编译订阅者程序。

Y ejecutamos ambos programas

然后两个程序都运行(先跑订阅者,再跑发布者)。

要能默写:gcc -o 输出名 源文件.c -lmosquitto。三个要素——-o 指定输出名、源文件在前、-lmosquitto 在最后。先运行订阅者再运行发布者,否则若用 QoS 0,那条消息没有订阅者接,直接丢弃。
原文两条命令里的 –lmosquitto 又是长破折号(–),不是短横线(-)。复制粘贴到终端会得到 "unrecognized option",改为 -lmosquitto 即可。这是讲义里重复出现两次的同一个排版错误。
编译口诀:"-o 取名,源文件随后,-l 收尾"。运行口诀:"先听(sub)后说(pub)"。

六、SSL/TLS、认证与 MQTT 5

p.21–p.24
p.21

MQTT con SSL · TLS 连接配置

▸ 原页截图 p.21原讲义第 21 页

MQTT con SSL

带 SSL 的 MQTT(本页标题)。

En este caso tenemos que indicar algunas opciones adicionales al conectar:

此时连接时要额外指定一些选项:

#define CA_FILE "/etc/ssl/certs/ca-certificates.crt“

定义 CA 证书文件路径:用来校验 bróker 的服务器证书。

#define PORT 8883

把端口改为 8883(MQTT over TLS 的标准端口)。

mosquitto_tls_set(mosq, CA_FILE, NULL, NULL, NULL, NULL);

启用 TLS 并指定 CA 文件;其余参数(客户端证书、私钥等)传 NULL 表示不用双向认证。

/* No usar en entornos reales, no comprueba identidad servidor */

注释:不要在生产环境使用,因为它不校验服务器身份。

//mosquitto_tls_insecure_set(mosq, true);

被注释掉的"不安全模式"开关(true = 跳过主机名校验,容易被中间人攻击)。

rc = mosquitto_connect(mosq, BROKER, PORT, 60);

再用 8883 端口连接(代码其他部分与 p.16 相同)。

三步必答:① 端口 1883 → 8883;② 调 mosquitto_tls_set 指定 CA 证书;③ 不要开 insecure 模式。问"为什么 MQTT 能用 TLS"→ 因为它跑在 TCP 之上(p.12 第 6 条),TCP 能加 TLS 层。
原文的 CA_FILE 那行结尾同样是中文式开引号 …crt“,正确应为 "…crt";另外 rc 仍未声明。抄代码时这两处必须自己修。
端口记法:1883 明文 / 8883 加密,只差第一位变成 8。tls_insecure_set(true) 名字里带 insecure,就是"不安全",考试问"能否用于生产"答 no。
p.22

MQTT con SSL · 用户名与密码认证

▸ 原页截图 p.22原讲义第 22 页

También es muy habitual que tengamos que indicar un usuario y contraseña para conectarnos al bróker

连接 bróker 时也很常见地需要提供用户名和密码。

Para ello usamos la función mosquitto_username_pw_set

为此使用 mosquitto_username_pw_set 函数(必须在 connect 之前调用)。

Ejemplo:

示例:

mosquitto_username_pw_set(mosq, "alumno", “mipassword");

为连接设置用户名 “alumno”、密码 “mipassword”。

调用顺序是考点:new → username_pw_set → connect。认证信息必须先挂到句柄上,连接时才随 CONNECT 报文发出去。与 TLS 搭配即构成"加密 + 认证"的最小安全配置。
原文第二个参数前是直引号 "alumno",第三个参数前却是弯引号 “mipassword",混用会编译不过。写代码统一用直引号 "mipassword"。
函数名拆开就懂:username + pw + set = 设置用户名和密码。脑子里排好队:先报身份,再进门。
p.23

MQTT 5 · 定位与目标

▸ 原页截图 p.23原讲义第 23 页

MQTT 5

MQTT 5(本页标题)。

MQTT 5 incluye muchas nuevas características

MQTT 5 包含许多新特性。

No es compatible hacia atrás (existen soluciones híbridas que incluyen también MQTT 3.1.1)

不向后兼容(存在"混合方案",即同时支持 MQTT 3.1.1)。

Objetivos principales

主要目标:

Escalabilidad y sistemas a gran escala

可扩展性与大规模系统。

Informe de errores mejorado

改进的错误报告。

Mecanismos de extensibilidad (user properties)

可扩展机制(用户属性 user properties)。

Mejoras en rendimiento y soporte para clientes pequeños

性能提升,并更好地支持小型客户端。

一句话结论必须能答:"¿MQTT 5 es compatible hacia atrás?" → No,但存在同时兼容 3.1.1 的 soluciones híbridas。四个目标按"大(规模)— 清(错误报告)— 扩(user properties)— 快(性能/小客户端)"记。
别把"不兼容"说成"完全不能用":bróker 可以同时监听 3.1.1 与 5 的客户端(混合方案),只是同一条连接上的协议版本不兼容。答"不可以混用同一条连接"才准确。
MQTT 5 = "大、清、扩、快":更大规模、更清楚报错、可扩展属性、更快更省。
p.24

MQTT 5 · 具体新特性

▸ 原页截图 p.24原讲义第 24 页

Más específicamente (algunos son opcionales)

更具体地说(其中有些是可选的):

La expiración de sesiones y mensajes se puede indicar en segundos

会话与消息的过期时间可以用秒指定(回答了 p.11 的"存多久")。

Propiedades de usuario en los mensajes (una especie de cabecera)

消息里的用户属性(相当于自定义头部)。

Suscripciones compartidas (balanceo de carga)

共享订阅(多个订阅者分摊消息,做负载均衡)。

Códigos de error y ACKs negativos (reason strings)

错误码与否定 ACK(带原因字符串 reason strings)。

Indicador del formato del payload (“content type”)

负载格式指示(content type,告诉对方是 JSON 还是文本)。

Patrón Request / Response

请求/响应模式(在发布订阅之上模拟一问一答)。

Alias para los tópicos (alias numéricos para reducir el tamaño de los mensajes)

主题别名(用数字别名代替长主题,减小报文体积)。

Flujo de control (número máximo de mensajes para ser procesados concurrentemente)

流控(限制并发处理的最大消息数,防止订阅端被压垮)。

Algunos ejemplos están disponibles en Campus Virtual

一些示例可在 Campus Virtual(课程平台)上获取。

至少要能列举 4 条并各配一句解释:expiración(秒级过期)、user properties(自定义头)、suscripciones compartidas(负载均衡)、reason strings(错误原因)、content type、Request/Response、topic alias(省带宽)、flow control。这 8 条里挑 4 条就能拿满。
topic alias 不是改名:主题本身没变,只是同一条连接上后续用 2 字节数字代替原字符串,连接建立时先映射一次。答成"主题可以起别名"会被追问穿帮。
一条记忆链:过期(时间)→ 属性(头)→ 共享(分摊)→ 错误(原因)→ 格式(类型)→ 请求响应 → 别名(省字节)→ 流控(限并发)。八件事全都在解决"大规模 + 省资源"。

七、全章总结

p.25
p.25

En resumen… · 小结

▸ 原页截图 p.25原讲义第 25 页

En resumen…

总而言之……

MQTT es un protocolo muy utilizado en IoT

MQTT 是物联网中使用极广的协议。

Utiliza un modelo de publicación-suscripción

它采用发布-订阅模型。

El bróker es el elemento central de MQTT

bróker 是 MQTT 的核心元素(所有流量都经过它)。

Puede ser utilizado en dispositivos con pocos recursos

可用于资源很少的设备。

MQTT 5 incluye muchas nuevas características

MQTT 5 包含许多新特性。

这五行就是全章"背诵版答案":IoT 常用 + 发布订阅 + bróker 中心 + 低资源可用 + MQTT 5 新特性。简答题结尾抄这五句,稳且不出错。
全场只需要记住一幅图:发布者 → bróker → 订阅者,配上三个旋钮——topic(发到哪)、QoS(多可靠)、retain/última voluntad(状态与遗言)。

八、专有名词总表

A–Z · 全章 25 页

专有名词速记表(A–Z)

按西语字母排序,点页码直接跳回对应页块。最后一列是「一句话记住 / 易错点」——考前只扫这一列也能救急。

西语术语中文页一句话记住 / 易错点
A
acoplamiento / desacoplamiento耦合 / 解耦p.4发布者不认识订阅者,双方也不用同时在线
alias de tópicos主题别名p.24同一条连接内用数字代替长主题,只省字节,不是改名
ancho de banda带宽p.3MQTT 主打「低带宽」场景,报文头极小
autenticación认证p.22username_pw_set 必须在 connect 之前调用
ACK negativo否定确认p.24MQTT 5 靠它 + reason strings 说清错在哪
B
balanceo de carga负载均衡p.24共享订阅让多个订阅者分摊同一条消息
bróker消息代理p.4所有客户端只连它,它是整个系统的中心
broker.hivemq.com公共测试 brókerp.14不想在本机装 Mosquitto 时拿它练手
C
calidad de servicio (QoS)服务质量p.100 最多一次 / 1 至少一次 / 2 恰好一次
cliente客户端p.5发布者和订阅者都只是客户端,谁也不直连谁
comodín (wildcard)通配符p.7+ 只吃一层,# 吃到底且只能放末尾
content type内容类型p.24告诉对方 payload 是 JSON 还是纯文本
contraseña密码p.22和用户名成对出现,函数名里写作 pw
D
desacoplamiento解耦p.4空间上互不知道 + 时间上不必同时在线
dispositivo embebido嵌入式设备p.3资源少也能跑,这是 MQTT 的设计前提
E
escalabilidad可扩展性p.4加 bróker、加订阅者就能扩容,发布者不用改
expiración de sesiones y mensajes会话与消息过期p.24MQTT 5 用「秒」指定,正好回答 p.11 的「存多久」
evento / bucle de eventos事件 / 事件循环p.16loop_start 起后台线程去跑它
F
flujo de control流控p.24限制并发处理的消息数,别把订阅端压垮
H
HiveMQ公共 MQTT 测试平台p.9网页版点几下就能试订阅/发布
humedad湿度p.8花园例子里与 temperatura 并列的传感器量
I
informe de errores错误报告p.23MQTT 5 四大目标之一,靠 reason strings 落地
Internet of Things (IoT)物联网p.3MQTT 的主战场
J
jardín花园p.8灌溉例子的一级主题,用来演通配符
K
keep-alive心跳保活p.12超过这个时间没报文就判定掉线,随即触发遗嘱
L
libmosquitto-devMosquitto 开发库p.14装了它才有头文件,编译要加 -lmosquitto
M
M2M机器对机器p.3MQTT 起家于 M2M,后来才铺到 IoT
mensaje retenido保留消息p.11每个主题只留最后一条,新订阅者一连上就收到
Message Queue Telemetry TransportMQTT 全称p.3消息队列遥测传输
Mosquitto开源 brókerp.13Eclipse 出品,apt 一条命令装好
mosquitto_loop_forever阻塞式事件循环p.19订阅者主程序用,卡在这里直到断开
mosquitto_loop_start后台事件循环p.16发布者用,起线程后主程序继续往下走
mosquitto_pub命令行发布工具p.13-t 主题 -m 消息
mosquitto_sub命令行订阅工具p.13-t 主题,收到就打印
mosquitto_tls_setTLS 配置函数p.21设好 CA 文件后端口改 8883
mosquitto_username_pw_set用户名密码设置函数p.22拆开就是 username + pw + set
MQTT 3.1.1旧版协议p.3至今仍被广泛部署,别以为已淘汰
MQTT 5.0当前标准版本p.32019 年 3 月成为 OASIS 标准
N
nivel de tópico主题层级p.6用 / 分隔,像文件夹路径;/ 是分隔符不是前缀
O
OASIS标准化组织p.3MQTT 5.0 的标准发布方
uno a muchos一对多p.4一条发布,所有匹配主题的订阅者都收到
P
paso de mensajes消息传递p.1本章大标题:comunicación mediante paso de mensajes
payload负载p.18消息里真正的数据,如 {"temperature":20.0}
propiedades de usuario用户属性p.24消息自带的自定义头部,MQTT 5 才有
publicación-suscripción发布-订阅p.4不是点对点,而是全部经 bróker 转发
publicador (publisher)发布者p.15只管 publish,从不关心谁在收
puerto 1883明文默认端口p.14不加密,抓包能直接看内容
puerto 8883TLS 加密端口p.21只比 1883 首位多一个 8
Q
QoS 0最多一次p.10发了就不管,丢了也不知道,最快
QoS 1至少一次p.10有确认,保证到达,但可能重复
QoS 2恰好一次p.10四次握手,最安全最慢,不丢不重
R
reason strings原因字符串p.24错误码 + 一句人话,MQTT 5 的报错升级
Request / Response请求 / 响应p.24在 pub/sub 之上模拟一问一答
retenido (flag)保留标志p.11发布时置位,bróker 替这个主题留最后一条
riego灌溉p.8花园例子:Riego en jardines
S
sesión persistente持久会话p.11断线期间替你存 QoS 1/2 消息,重连后补发
SSL/TLS传输层加密p.12跑在 TCP 之上,MQTT 本身不加密
suscripción compartida共享订阅p.24多订阅者分摊同一条消息,做负载均衡
suscriptor (subscriber)订阅者p.17连上后第一件事就是 subscribe
suscribirse (subscribe)订阅p.17在 on_connect 回调里调 mosquitto_subscribe
T
TCP/IP传输层基础p.4MQTT 建立在它之上,所以是有序可靠字节流
temperatura温度p.8贯穿全章的示例传感器量
tópico主题p.6消息靠它路由,不是靠 IP 地址
topic alias主题别名p.24等同 alias de tópicos,只是省报文体积
U
última voluntad遗嘱消息p.12客户端猝死时,由 bróker 代它发最后一条
V
voluntad遗嘱p.12见 última voluntad;要预先登记主题与 QoS
W
wildcard通配符p.7只有 + 和 # 两个,别自己发明 *
WebSocket网页传输p.9浏览器里试 MQTT 靠它,地址以 ws:// 开头

九、编号与数字速记卡

12 个必背数字

数字一背就中

口诀:1999 生、2019 定;1883 明文、8883 加密;QoS 0-1-2,加号一层、井号到底。考试问「哪年」「哪个端口」「哪级 QoS」,答案只可能是下表里的数。

数字原文关键词中文性质页
1999creado en 1999MQTT 诞生年份时间p.3
3.1.1MQTT 3.1.1仍在广泛部署的旧版协议版本p.3
5.0marzo de 2019 · OASIS当前标准版本版本p.3
1883puerto 1883明文默认端口端口p.14
8883PORT 8883TLS 加密端口端口p.21
0QoS 0最多一次,可能丢QoSp.10
1QoS 1至少一次,可能重QoSp.10
2QoS 2恰好一次,最安全最慢——问「最可靠」选它QoSp.10
60connect(..., 60)keep-alive 秒数示例参数p.16
+nivel único单层通配,可在一层里代表任意值通配p.7
#todos los niveles多层通配,只能放末尾通配p.7
-1, 1loop_forever(mosq, -1, 1)无限等待、1 秒超时参数p.19

十、易混概念对照卡

13 对 · 差别只在关键词

差在哪一个词上

每对只差一个词,答题时写错这个词就全错。左卡右卡各记一句,别背长段。

QoS 1 · 至少一次
有 PUBACK,一定到,但重发会造成重复。
QoS 2 · 恰好一次
四次握手,不丢不重,代价是最慢。
+ · 单层
只代替一层,可在一串主题里出现多次。
# · 多层
吃掉剩余所有层,只能放末尾。
mensaje retenido · 保留消息
bróker 为每个主题存最后一条,给所有新订阅者。
sesión persistente · 持久会话
bróker 为同一个客户端存离线期间的 QoS 1/2 消息。
mosquitto_loop_start
起后台线程跑事件循环,主程序继续往下走。
mosquitto_loop_forever
阻塞当前线程,一直跑到断开为止。
1883
明文,抓包可见内容,只能内网/测试用。
8883
TLS 加密,生产环境走这个。
MQTT 3.1.1
兼容性最好,设备与 bróker 几乎都支持。
MQTT 5
不向后兼容;但可混合部署(bróker 同时听两版)。
publicador
只调 publish,不知道谁在收。
suscriptor
先 subscribe,再在 on_message 回调里收。
tópico
路由地址,决定这条消息发给谁。
payload
真正数据,MQTT 不关心它的格式。
bróker
中心节点,负责接收、匹配、转发。
cliente
端点,可以是发布者、订阅者,或两者兼是。
-lmosquitto(正确)
短横线 + 小写 L,链接 libmosquitto。
–lmosquitto(原文笔误)
长破折号,编译直接失败,抄的时候必须改回短横线。
SSL/TLS
解决通道被窃听:内容加密。
usuario / contraseña
解决你是谁:身份认证。两者互补,不是二选一。
última voluntad · 遗嘱
客户端异常断线时,bróker 代发一次。
mensaje retenido · 保留
客户端正常发布时置位,长期留着给后来者。
suscripción compartida
多个订阅者分摊同一条消息(负载均衡)。
comodín
一个订阅者匹配多个主题(扩大范围)。