Повышение 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 QoSGranted subscription QoSДоставка subscriberЧто учитывать
00, 1 или 2QoS 0Потеря допустима протоколом
10QoS 0Hop к subscriber может потерять сообщение
11 или 2QoS 1Возможны дубликаты
20QoS 0Высокий publish QoS понижен подпиской
21QoS 1Возможны дубликаты
22QoS 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: missing

PUBACK подтверждает передачу 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 хранит состояние и очередь для ушедших клиентов.

Выбор уровня зависит от цены потери и дубликата

  1. Для частых показаний, где следующая точка заменяет предыдущую, оценить QoS 0 и метрику gaps.
  2. Для событий, которые нельзя терять, использовать QoS 1 плюс idempotency key и durable session.
  3. QoS 2 выбирать, когда дубликат на protocol hop недопустим и дополнительный handshake приемлем.
  4. Команды устройству снабжать command ID и хранить результат, потому что сетевое exactly once не гарантирует однократное действие реле.
  5. Настроить 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.

Проверенные источники