MQTT 5 vs. MQTT 3.1.1: die wichtigsten Unterschiede
MQTT 5 behält das Publish/Subscribe-Modell von MQTT 3.1.1 bei, ergänzt aber Reason Codes in allen Bestätigungen, Properties wie User Properties und Message Expiry, Session Expiry, Shared Subscriptions, Topic Aliases, Request/Response und Flow Control. Beide Versionen sind OASIS-Standards, und ein Broker kann beide gleichzeitig bedienen, sodass Sie Clients schrittweise umstellen können.
Was unterscheidet MQTT 5 von MQTT 3.1.1?
MQTT 5 ist eine Weiterentwicklung von MQTT 3.1.1, die das Grundmodell beibehält und bessere Fehlermeldungen, Metadaten sowie mehr Kontrolle über Sessions und Last ergänzt. Topics, Wildcards, QoS 0/1/2, Retained Messages und Last Will funktionieren in beiden Versionen gleich.
MQTT 3.1.1 wurde 2014 OASIS-Standard und später als ISO/IEC 20922 veröffentlicht. MQTT 5.0 ist seit 2019 OASIS-Standard. Ein MQTT 4 gibt es nicht: Das Protocol-Level-Byte im CONNECT-Paket ist bei MQTT 3.1.1 bereits 4, bei MQTT 5 ist es 5, und die neue Version hat die Nummer übernommen.
Die wichtigste strukturelle Änderung sind die Properties. Die meisten MQTT-5-Pakete enthalten im Variable Header eine optionale Liste von Properties. Fast jede neue Funktion ist als Property umgesetzt. Deshalb konnte MQTT 5 viel ergänzen, ohne das Publish/Subscribe-Prinzip zu verändern.
Die Tabelle zeigt die Änderungen, mit denen Entwickler in der Praxis am häufigsten zu tun haben.
| Funktion | MQTT 3.1.1 | MQTT 5 |
|---|---|---|
| Bestätigungen | Return Codes nur in CONNACK und SUBACK | Reason Codes in CONNACK, PUBACK, PUBREC, PUBREL, PUBCOMP, SUBACK, UNSUBACK, DISCONNECT und AUTH |
| Session-Steuerung | Flag Clean Session | Flag Clean Start plus Session Expiry Interval |
| Lebensdauer von Nachrichten | Nachrichten warten bis zur Zustellung | Message Expiry Interval pro Nachricht |
| Eigene Metadaten | Nur im Payload | User Properties (Schlüssel/Wert-Paare) |
| Lastverteilung | Nicht im Standard | Shared Subscriptions: $share/<group>/<filter> |
| Header-Größe | Vollständiger Topic-Name in jedem PUBLISH | Topic Aliases ersetzen den Namen durch eine Zahl |
| Request/Response | Nur per Konvention | Properties Response Topic und Correlation Data |
| Flow Control | Nicht definiert | Receive Maximum begrenzt unbestätigte QoS-1/2-Nachrichten |
| Maximale Paketgröße | Nicht ausgehandelt | Maximum Packet Size, von Client und Server angekündigt |
| Verbindungsabbau durch den Server | Server schließt die Verbindung ohne Begründung | Server kann DISCONNECT mit Reason Code senden |
| Authentifizierung | Benutzername und Passwort im CONNECT | Zusätzliches AUTH-Paket für Challenge/Response-Verfahren |
| Subscription-Optionen | Nur QoS | QoS, No Local, Retain As Published, Retain Handling |
| Payload-Beschreibung | Keine | Payload Format Indicator und Content Type |
Reason Codes und DISCONNECT durch den Server
MQTT 5 teilt dem Client mit, warum etwas fehlgeschlagen ist, und nicht nur, dass es fehlgeschlagen ist. In MQTT 3.1.1 enthält ein PUBACK keinen Status. Lehnt der Broker eine Nachricht ab, etwa weil der Client für dieses Topic nicht berechtigt ist, schließt er in der Regel einfach die Verbindung. Der Client muss die Ursache erraten.
In MQTT 5 enthält jede Bestätigung einen Reason Code. Werte unter 0x80 bedeuten Erfolg, Werte ab 0x80 einen Fehler. Ein PUBACK kann zum Beispiel „Not authorized“ (0x87) oder „No matching subscribers“ (0x10) melden. Der Server kann außerdem ein DISCONNECT-Paket mit einem Grund wie „Session taken over“ oder „Keep Alive timeout“ senden, bevor er die Verbindung schließt. Die optionale Property Reason String liefert zusätzlich einen lesbaren Text für die Fehlersuche.
Sessions und Ablaufzeit von Nachrichten
MQTT 5 trennt die Frage „neu beginnen?“ von der Frage „wie lange Zustand aufbewahren?“. In MQTT 3.1.1 bedeutet Clean Session = 0, dass der Broker die Session mit ihren Subscriptions und wartenden QoS-1/2-Nachrichten ohne festgelegtes Ende aufbewahrt. Bei großen Geräteflotten bleibt so Zustand für Geräte liegen, die sich nie wieder verbinden.
MQTT 5 teilt das in zwei Einstellungen auf:
- Clean Start: Ist das Flag gesetzt, verwirft der Broker beim Verbindungsaufbau eine vorhandene Session.
- Session Expiry Interval: Anzahl Sekunden, die der Broker die Session nach dem Verbindungsende aufbewahrt. 0 bedeutet, dass die Session mit der Verbindung endet; 0xFFFFFFFF bedeutet, dass sie nicht abläuft.
Das Message Expiry Interval gilt pro Nachricht. Wartet eine Nachricht länger als dieses Intervall in einer Queue, verwirft der Broker sie, statt veraltete Daten zuzustellen. Mit dem verwandten Will Delay Interval wartet der Broker, bevor er einen Last Will veröffentlicht. So löst ein kurzer Netzwerkaussetzer nicht sofort einen Offline-Alarm aus.
Shared Subscriptions und Subscription-Optionen
Mit Shared Subscriptions teilen sich mehrere Clients die Nachrichten einer Subscription. Ein Client abonniert $share/<group>/<filter>, und der Broker stellt jede passende Nachricht nur einem Mitglied der Gruppe zu:
$share/ingest/plant/+/temp
Abonnieren drei Instanzen eines Backend-Dienstes diesen Filter, erhält jede einen Teil des Datenstroms. Das ist der standardisierte Weg, Consumer horizontal zu skalieren.
Zusätzlich führt MQTT 5 drei Subscription-Optionen ein:
- No Local: Der Client erhält über diese Subscription nicht seine eigenen Nachrichten.
- Retain As Published: Das Retain-Flag wird so weitergegeben, wie der Publisher es gesetzt hat. Das benötigen vor allem Bridges.
- Retain Handling: Legt fest, ob Retained Messages beim Abonnieren gesendet werden (0 = immer, 1 = nur bei neuer Subscription, 2 = nie).
Topic Aliases, Flow Control und Paketgröße
Diese Funktionen schonen Bandbreite und Speicher, sowohl auf schmalbandigen Verbindungen als auch auf stark ausgelasteten Brokern.
Topic Aliases
Ein Sender kann einen Topic-Namen wie enterprise/site-frankfurt/line-3/press-07/temp einer kleinen Zahl zuordnen und in folgenden PUBLISH-Paketen nur noch diese Zahl senden. Mit Topic Alias Maximum gibt jede Seite an, wie viele Aliases sie akzeptiert. Aliases gelten nur für die aktuelle Netzwerkverbindung.
Receive Maximum
Jede Seite gibt an, wie viele QoS-1- und QoS-2-Nachrichten gleichzeitig unbestätigt sein dürfen. Der Sender darf diese Zahl nicht überschreiten. Das ergibt eine einfache Form von Back-Pressure.
Maximum Packet Size
Client und Server können die größte Paketgröße angeben, die sie annehmen. Der Server darf diesem Client keine größeren Pakete senden, sodass ein kleines Gerät nicht von einem übergroßen Payload überlastet wird.
Request/Response, User Properties und erweiterte Authentifizierung
MQTT 5 standardisiert Muster, die Teams bisher über eigene Konventionen gelöst haben.
Request/Response: Der Anfragende veröffentlicht mit einem Response Topic und Correlation Data. Der Antwortende sendet seine Antwort an dieses Topic und übernimmt die Correlation Data, sodass der Anfragende Antworten den Anfragen zuordnen kann.
User Properties: Beliebig viele UTF-8-Schlüssel/Wert-Paare in den meisten Pakettypen. Bei PUBLISH werden sie an die Subscriber weitergereicht. Teams nutzen sie für Trace-IDs, Einheiten oder Schema-Versionen, ohne den Payload zu ändern.
Erweiterte Authentifizierung: Im CONNECT-Paket kann eine Authentication Method angegeben werden, anschließend tauschen Client und Server AUTH-Pakete für Challenge/Response-Verfahren aus. Der Client kann sich zudem während einer laufenden Verbindung erneut authentifizieren.
Lohnt sich der Umstieg auf MQTT 5?
Für neue Systeme ist MQTT 5 meist die bessere Wahl, weil Fehler sichtbar werden und sich Sessions, Last und Lebensdauer von Nachrichten steuern lassen. Die Migration kann schrittweise erfolgen: Ein Broker, der beide Versionen unterstützt, lässt 3.1.1- und 5-Clients über dieselben Topics Nachrichten austauschen. Prüfen Sie, ob Ihre Client-Bibliotheken und Ihr Broker die geplanten MQTT-5-Funktionen unterstützen, und behalten Sie MQTT 3.1.1 dort bei, wo sich ein Gerät nicht aktualisieren lässt.