Повышение publisher QoS до 2 не исправит клиента, который каждый раз подключается с новой пустой session, подписан с максимумом QoS 0 или не успевает обработать сообщение до crash. Выберите один потерянный message ID и проследите его по трём участкам: device → broker, broker queue/session, broker → consumer. На каждом участке своя гарантия и своё подтверждение.
Стандарт MQTT определяет QoS 0 как at most once, QoS 1 как at least once и QoS 2 как exactly once для доставки Application Message между одним sender и одним receiver. Это не делает бизнес-операцию exactly once: consumer может записать данные, упасть до своего checkpoint и выполнить запись повторно после повторной доставки.
Итоговый QoS может оказаться ниже ожидаемого
| Publisher QoS | Granted subscription QoS | Доставка subscriber | Что учитывать |
|---|---|---|---|
| 0 | 0, 1 или 2 | QoS 0 | Потеря допустима протоколом |
| 1 | 0 | QoS 0 | Hop к subscriber может потерять сообщение |
| 1 | 1 или 2 | QoS 1 | Возможны дубликаты |
| 2 | 0 | QoS 0 | Высокий publish QoS понижен подпиской |
| 2 | 1 | QoS 1 | Возможны дубликаты |
| 2 | 2 | QoS 2 | Выше overhead, но бизнес side effect всё равно идемпотентен |
OASIS требует отправлять сообщение подписчику с минимумом publish QoS и granted maximum QoS. Поэтому логируйте SUBACK reason code: requested QoS не доказывает, что broker его выдал. CONNACK также может объявить Maximum QoS сервера.
Trace протокола отделяет потерю от обработки
message_id: sensor-42/b-19/18422
publisher:
qos: 1
publish_sent: 18:30:01.120Z
puback_received: 18:30:01.168Z
broker_session:
client_id: telemetry-writer-1
session_present: true
session_expiry_s: 3600
subscriber:
granted_qos: 1
publish_received: 18:30:04.011Z
puback_sent: 18:30:04.013Z
application:
idempotency_key: sensor-42/b-19/18422
database_commit: missingPUBACK подтверждает передачу ownership на protocol hop, а не commit в вашей базе. В примере MQTT доставил сообщение, но application commit отсутствует. Consumer должен подтверждать в безопасном порядке, поддерживаемом библиотекой, либо иметь идемпотентную запись и durable checkpoint. Не пытайтесь лечить такой разрыв QoS 2 без изменения приложения.
Offline-получатель зависит от session, а не от retain
- Стабильный Client ID нужен, чтобы broker узнал прежнюю session после reconnect.
- Clean Start и Session Expiry задают, сохраняется ли subscription и очередь после отключения.
- Client проверяет Session Present в CONNACK; false означает, что прежнего состояния у broker нет.
- Message Expiry может удалить ожидавшее сообщение раньше возвращения устройства.
- Retained message хранит последнее значение topic для новых подписок, но не является общей offline-очередью событий.
- Broker persistence и лимиты очереди должны переживать restart и ожидаемый offline-период.
MQTT 5 прямо описывает: при Clean Start=1 и Session Expiry=0 клиент получает сообщения только пока подключён и подписывается заново. При кратком expiry reconnect может продолжить надёжную доставку, но после истечения session сообщения теряются. Слишком длинный expiry тоже имеет цену — broker хранит состояние и очередь для ушедших клиентов.
Выбор уровня зависит от цены потери и дубликата
- Для частых показаний, где следующая точка заменяет предыдущую, оценить QoS 0 и метрику gaps.
- Для событий, которые нельзя терять, использовать QoS 1 плюс idempotency key и durable session.
- QoS 2 выбирать, когда дубликат на protocol hop недопустим и дополнительный handshake приемлем.
- Команды устройству снабжать command ID и хранить результат, потому что сетевое exactly once не гарантирует однократное действие реле.
- Настроить message expiry по бизнес-смыслу: устаревшая команда иногда опаснее потерянной.
Считайте нагрузку вместе с гарантиями. QoS 1 держит unacknowledged state и допускает повтор, QoS 2 использует двухшаговое подтверждение. Поднимать уровень всем topics без измерения может заполнить broker queues и ускорить disconnect медленных consumers.
Тест reconnect воспроизводит пропуск за десять минут
Подпишите consumer со стабильным Client ID, убедитесь в granted QoS, затем отключите его, опубликуйте пронумерованные сообщения и подключите до expiry. Ожидайте Session Present=true и полный набор IDs. Повторите после expiry — отсутствие старой очереди должно быть ожидаемым результатом. Потом перезапустите broker и проверьте, соответствует ли поведение включённой persistence.
Исправление принято, когда у каждого пропуска есть классификация: не отправлено, не подтверждено publisher-broker, удалено session/message expiry, понижено subscription QoS, отброшено лимитом или потеряно после delivery в application. Для разбора сохраните broker version, CONNECT/CONNACK/SUBACK properties и обезличенный trace одного message ID.