Nicht jede Nachricht ist gleich wichtig. Ein Temperaturwert, der alle 30 Sekunden kommt, darf ruhig einmal verloren gehen, der nächste folgt gleich. Ein Befehl an das Garagentor dagegen muss ankommen, und er darf nicht versehentlich zweimal ausgeführt werden. MQTT bietet für solche Unterschiede mehrere Werkzeuge. Wie Broker, Clients und Topics zusammenspielen, erklärt Teil 1.
Das beschriebene Verhalten des Brokers ist mit Mosquitto 2.1.4 geprüft, Stand: November 2026.
Drei Stufen der Zustellung
Bei jeder Nachricht legt der Sender fest, wie sicher sie ankommen soll. Diese Stufe heißt Quality of Service, kurz QoS.
- QoS 0: höchstens einmal
- Der Sender schickt die Nachricht und vergisst sie. Meist kommt sie an, bricht aber genau in diesem Moment die Verbindung ab, ist sie verloren.
- Passt zu häufigen Messwerten.
- QoS 1: mindestens einmal
- Der Sender hebt die Nachricht auf, bis eine Bestätigung kommt. Bleibt sie aus, sendet er nach dem Wiederverbinden erneut. Hatte der Empfänger die erste Nachricht schon erhalten, bekommt er sie doppelt.
- Passt zu Zuständen und den meisten Befehlen.
- QoS 2: genau einmal
- Vier Schritte verhindern Duplikate, kosten aber am meisten Zeit.
- Passt zu Befehlen, bei denen eine Wiederholung schadet.
So laufen die vier Schritte bei QoS 2 ab:
- Senden (PUBLISH)
Der Sender schickt die Nachricht und hebt sie auf.
- Empfang melden (PUBREC)
Der Empfänger bestätigt und merkt sich die Nummer der Nachricht. Trifft dieselbe Nachricht noch einmal ein, erkennt er sie daran.
- Freigeben (PUBREL)
Der Sender verwirft seine Kopie und bittet den Empfänger, die Nummer freizugeben.
- Abschließen (PUBCOMP)
Der Empfänger gibt die Nummer frei und bestätigt. Erst jetzt ist der Vorgang für beide Seiten beendet.
Jede Stufe kostet mehr als die vorige: Je Teilstrecke sind es eine, zwei oder vier Nachrichten, dazu kommen Wartezeit und Speicher auf beiden Seiten. Für Messwerte reicht meist QoS 0, für Zustände und die meisten Befehle QoS 1.
Was QoS nicht garantiert
QoS wirkt nicht von einem Ende zum anderen, sondern auf jeder Teilstrecke getrennt: einmal vom Sender zum Broker, einmal vom Broker zu jedem Abonnenten. Der Abonnent legt beim Abonnieren seine eigene Höchststufe fest, und es gilt die niedrigere der beiden. Sendet ein Gerät mit QoS 2 und hat das Dashboard mit QoS 0 abonniert, kommt die Nachricht dort mit QoS 0 an.
Auch „genau einmal“ bezieht sich nur auf die Übertragung. Stürzt das empfangende Programm ab, nachdem die Nachricht angekommen ist, aber bevor es den Befehl ausgeführt hat, hilft QoS 2 nicht. Und startet ein Broker ohne Persistenz neu, sind alle Nachrichten verloren, die er gerade aufbewahrt hat. Mosquitto speichert in der Grundeinstellung nichts auf der Festplatte. Wie man das einschaltet, zeigt Teil 3.
Robuster als jede QoS-Stufe ist ein Befehl, der bei Wiederholung nichts anrichtet: „Sollwert 21 Grad“ statt „zwei Grad wärmer“, „Licht an“ statt „Licht umschalten“. Kommt so ein Befehl doppelt an, bleibt das Ergebnis gleich, und QoS 1 genügt.
Retained Messages: der letzte Stand
Ein Abonnent bekommt normalerweise nur Nachrichten, die nach seinem Abonnement gesendet werden. Ein Dashboard, das gerade neu gestartet ist, wüsste also nicht, ob das Fenster offen ist, bis sich daran etwas ändert. Dafür gibt es das Retain-Flag. Ist es gesetzt, hebt der Broker die Nachricht als letzten Stand ihres Topics auf und liefert sie jedem neuen Abonnenten sofort.
- Retained Message
- Die letzte Nachricht eines Topics, die der Broker aufbewahrt. Es gibt höchstens eine pro Topic, eine neue ersetzt die alte.
- Gelöscht wird sie mit einer leeren Nachricht mit Retain-Flag an dasselbe Topic.
Retained Messages sind kein Verlauf. Sie beantworten nur die Frage, wie der Stand gerade ist. Für Zustände wie Sollwerte, Fensterkontakte oder die Erreichbarkeit eines Geräts sind sie ideal.
Ein Befehl wie „Garagentor öffnen“ darf nie als Retained Message gesendet werden. Der Broker liefert ihn sonst jedes Mal erneut aus, wenn sich das Tor neu verbindet, etwa nach einem Stromausfall. Im Test kam der gespeicherte Befehl bei jedem neuen Abonnement wieder an. Retain gehört zu Zuständen wie …/soll, nicht zu Befehlen wie …/soll/set.
Last Will: Ausfälle erkennen
Beim Verbinden kann ein Client eine Nachricht hinterlegen, die der Broker veröffentlicht, falls die Verbindung unerwartet endet. Sie heißt Last Will, also letzter Wille. Trennt sich der Client ordentlich, verwirft der Broker sie. Zusammen mit Retained Messages ergibt das ein einfaches Muster für die Erreichbarkeit eines Geräts, hier mit dem Status-Topic haus/wohnzimmer/thermostat/status:
- Beim Verbinden
Das Thermostat hinterlegt als Last Will die Nachricht „offline“ für sein Status-Topic, mit Retain-Flag.
- Nach dem Verbinden
Es sendet selbst „online“ an dasselbe Topic, ebenfalls mit Retain-Flag.
- Bei einem Ausfall
Der Broker veröffentlicht den Last Will. Jedes Dashboard sieht „offline“, auch eines, das erst später startet.
Wie schnell das geht, hängt von der Art des Ausfalls ab. Stürzt das Programm ab, schließt das Betriebssystem die Verbindung, und der Broker meldet den Ausfall sofort. Im Test geschah das in derselben Sekunde. Fällt dagegen der Strom aus oder reißt das WLAN ab, bleibt die Verbindung für den Broker scheinbar bestehen. Dann hilft nur das Keep Alive.
Keep Alive: Lebenszeichen
- Keep Alive
- Ein Zeitraum in Sekunden, den der Client beim Verbinden festlegt. Hat er so lange nichts gesendet, schickt er ein kurzes Lebenszeichen (PINGREQ), und der Broker antwortet (PINGRESP).
- Hört der Broker das Anderthalbfache dieser Zeit nichts, trennt er die Verbindung und veröffentlicht den Last Will. Bei 30 Sekunden sind das 45 Sekunden, genau so lange hat es im Test gedauert.
Kurze Werte erkennen Ausfälle schneller, kosten aber mehr Datenverkehr und bei Akkugeräten mehr Strom. Geräte, die sich zum Stromsparen schlafen legen, lösen das nicht mit einem sehr langen Keep Alive. Sie verbinden sich beim Aufwachen, senden ihre Werte, trennen sich ordentlich und schlafen weiter. Weil das ordentliche Trennen keinen Last Will auslöst, melden sie ihren Zustand selbst, am besten als Retained Message.
Sessions: was der Broker sich merkt
Verbindungen brechen ab, im Mobilfunk und im WLAN ganz alltäglich. Damit ein Gerät danach nichts verpasst, kann der Broker eine Session aufbewahren: die Abonnements des Clients und alle Nachrichten mit QoS 1 und 2, die in der Zwischenzeit eingetroffen sind. Erkannt wird der Client an seiner Client-ID, sie muss deshalb fest und eindeutig sein.
- Saubere Session
- MQTT 3.1.1: Clean Session an.
- MQTT 5.0: Clean Start an, Session Expiry 0.
- Nach dem Trennen bleibt nichts erhalten.
- Persistente Session
- MQTT 3.1.1: Clean Session aus.
- MQTT 5.0: Clean Start aus, Session Expiry zum Beispiel 3600 Sekunden.
- Abonnements und verpasste Nachrichten bleiben erhalten, bei MQTT 5 bis zum Ablauf der Frist.
Im Test lieferte Mosquitto nach dem Wiederverbinden die verpassten Nachrichten mit QoS 1 nach, die mit QoS 0 nicht. Bei MQTT 5 war die Session nach Ablauf der eingestellten Frist verschwunden. Ganz ohne Grenzen geht es nicht: Broker begrenzen, wie viele Nachrichten sie je Client aufheben. Ein Gerät, das wochenlang offline war, bekommt nicht alles nachgeliefert.
Mosquitto hebt für einen Client, der gerade nicht verbunden ist, in der Grundeinstellung nur Nachrichten auf, die bei ihm mit QoS 1 oder 2 ankämen. Dabei gilt die niedrigere Stufe von Sender und Abonnement. Ein Abonnement mit QoS 0 bekam im Test nichts nachgeliefert, obwohl der Sender QoS 1 verwendet hatte. Werkzeuge wie mosquitto_sub und die Python-Bibliothek paho-mqtt abonnieren ohne Angabe genau so. Wer nichts verpassen darf, abonniert deshalb ausdrücklich mit QoS 1, bei mosquitto_sub mit der Option -q 1.
MQTT 3.1.1 oder 5.0?
Beide Versionen laufen über denselben Port, der Broker erkennt beim Verbinden, welche ein Client spricht. Im Test arbeiteten Clients beider Versionen problemlos mit demselben Broker. MQTT 5.0 behält den einfachen Kern und ergänzt, was im Betrieb oft fehlte:
- Fehlercodes
- Der Broker begründet Ablehnungen. Darf ein Client ein Topic nicht beschreiben, verwirft der Broker die Nachricht bei MQTT 3.1.1 ohne jede Meldung. Bei MQTT 5.0 antwortet er mit dem Code 135, „Not authorized“, sofern die Nachricht mit QoS 1 oder 2 gesendet wurde.
- Ablaufzeiten
- Sessions und einzelne Nachrichten bekommen eine Frist. Ein veralteter Befehl verfällt, statt Stunden später ausgeführt zu werden.
- Verzögerter Last Will
- Der Broker wartet eine festgelegte Zeit, bevor er den Last Will veröffentlicht. Verbindet sich das Gerät vorher neu, entfällt er. So lösen kurze Aussetzer keinen Fehlalarm aus.
- Geteilte Abonnements
- Mehrere Programme teilen sich ein Abonnement, etwa $share/auswertung/haus/#. Jede Nachricht geht dann an genau eines von ihnen, das verteilt die Last. Im Test gingen vier Nachrichten abwechselnd an zwei Abonnenten. Bricht die Verbindung zum gewählten Programm ab, darf der Broker eine Nachricht mit QoS 1 laut Spezifikation einem anderen geben, sie kann dann doppelt verarbeitet werden. Mosquitto bietet das auch für MQTT 3.1.1 an.
- Anfrage und Antwort
- Eine Nachricht kann ein Antwort-Topic und eine Kennung mitbringen. So lassen sich Antworten der richtigen Anfrage zuordnen, etwa wenn ein Dashboard ein Gerät nach seiner Firmware-Version fragt.
Für neue Projekte empfiehlt sich MQTT 5.0, wenn Broker, Bibliotheken und Geräte es unterstützen. Viele kleine Geräte und ältere Bibliotheken beherrschen nur 3.1.1. Das ist kein Hindernis, denn beide Versionen arbeiten am selben Broker zusammen. Alle Neuerungen im Einzelnen, darunter weitere wie Topic-Aliase und eigene Zusatzfelder, beschreibt die Spezifikation von MQTT 5.0.
Fazit
QoS legt fest, wie sicher eine Nachricht auf jeder Teilstrecke ankommt, ersetzt aber keine Befehle, die Wiederholungen vertragen. Retained Messages halten den letzten Stand bereit, der Last Will meldet Ausfälle, und Sessions überbrücken Verbindungsabbrüche. Zusammen machen diese Werkzeuge aus einem einfachen Protokoll ein verlässliches System.
Teil 3 setzt das praktisch um: mit einem eigenen Mosquitto-Broker, einem Python-Programm und einer Absicherung mit Passwörtern, Zugriffsrechten und Verschlüsselung.