learn/mqtt

MQTT 5 vs. MQTT 3.1.1: die wichtigsten Unterschiede

Kurze Antwort

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.

Aktualisiert:

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.

01ultramq/learn/faq

Häufige Fragen

Ist MQTT 5 abwärtskompatibel zu MQTT 3.1.1?

Nicht auf Protokollebene: Jede Verbindung nutzt genau eine Protokollversion, die im CONNECT-Paket festgelegt wird. Ein Broker, der beide Versionen unterstützt, kann Nachrichten zwischen MQTT-3.1.1- und MQTT-5-Clients weiterleiten, 3.1.1-Clients sehen dabei aber keine MQTT-5-Properties.

Was ersetzt Clean Session in MQTT 5?

Das Flag Clean Start und das Session Expiry Interval. Clean Start legt fest, ob eine bestehende Session weiterverwendet wird, das Session Expiry Interval bestimmt, wie lange der Broker die Session nach dem Verbindungsende aufbewahrt.

Gibt es Shared Subscriptions in MQTT 3.1.1?

Nein. Shared Subscriptions mit der Syntax $share/<group>/<filter> wurden mit MQTT 5 standardisiert. Manche Broker bieten Ähnliches auch für 3.1.1-Clients an, das sind aber herstellerspezifische Erweiterungen.

Sollten neue Projekte MQTT 5 verwenden?

In den meisten Fällen ja, sofern Clients und Broker es unterstützen. MQTT 5 bietet eine klarere Fehlerbehandlung und mehr Kontrolle über Sessions und Last, MQTT 3.1.1 bleibt für sehr einfache oder ältere Geräte eine solide Wahl.

03ultramq/start

Sprechen Sie mit einem Engineer über Ihr Projekt.

Sagen Sie uns, was Sie verbinden möchten, wo es laufen muss und wohin die Daten fließen sollen. Wir antworten per E-Mail.

SUBultramq/#