Сначала определите, что именно оборвалось: TCP/WebSocket, TLS, MQTT Keep Alive или сессия на broker. Запишите время последнего успешного packet, событие смены сети, момент disconnect callback, каждую попытку CONNECT и ответ CONNACK. Без этой шкалы одинаково выглядят потеря радио, истёкший token и отклонённый дубликат client ID.

Не вызывайте connect из нескольких listeners одновременно. Один reconnect controller принимает сигналы ОС и клиента, но держит только одну активную попытку. После ошибки он ждёт backoff с jitter; после успешного CONNACK сбрасывает задержку и восстанавливает состояние по результату сессии.

Один timeline различает четыре вида разрыва

НаблюдениеВероятный слойСледующая проверка
Нет TCP connectСеть, DNS, портRoute, captive portal, reachability
TLS завершается ошибкойСертификат, часы, SNIКод TLS и цепочка сертификата
CONNACK с reason codeAuth, ACL, client ID, лимит brokerТочный reason без бесконечного retry
Соединение живёт до keep alive timeoutПотеря пакетов или зависший loopPINGREQ/PINGRESP и работа event loop
Reconnect успешен, сообщений нетСессия/подписки не восстановленыSession Present и SUBACK

Не записывайте пароль и содержимое пользовательских сообщений. Полезны client ID в усечённом виде, версия протокола, transport, network type, reason codes, номера попыток и размеры очередей. Корреляция по monotonic time помогает отделить задержку сети от скачка системных часов.

Clean Start и Session Expiry задают продолжение

MQTT 5 разделяет начало новой сессии и срок хранения состояния после disconnect. Спецификация указывает: при Clean Start=0 и существующей сессии broker продолжает её; Session Expiry определяет, как долго состояние сохраняется. Clean Start=1 вместе с нулевым expiry эквивалентен одноразовой чистой сессии.

client_id = "sensor-demo-42"
clean_start = false
session_expiry_interval = 1800
keep_alive = 45

on CONNACK:
  if session_present: continue queued flow
  else: subscribe again and rebuild local assumptions

Числа в примере условные. Expiry должен покрывать ожидаемый краткий обрыв, но не оставлять состояние навечно для исчезнувших устройств. Стабильный client ID обязателен для возобновления: случайный ID на каждый reconnect создаёт новую сессию. Одновременное использование одного ID двумя устройствами может, наоборот, выбивать соединения друг друга.

Backoff защищает broker и батарею

  • Первая повторная попытка идёт после короткой задержки, а не в tight loop.
  • Каждая неудача увеличивает интервал до разумного максимума.
  • Jitter разносит устройства, которые потеряли сеть одновременно.
  • Ошибки авторизации и запрещённый client ID не ретраятся бесконечно без изменения входных данных.
  • Сигнал network available разрешает раннюю попытку, но не запускает второй controller.

Eclipse Paho реализует automatic reconnect с увеличением задержки между попытками; конкретные пределы зависят от клиента. Это удобная основа, но приложению всё равно нужно различать transient network failure и постоянный отказ конфигурации, а также показывать наблюдаемое состояние пользователю.

QoS не отменяет прикладную дедупликацию

QoS 1 означает доставку как минимум один раз, поэтому после разрыва возможен повтор. QoS 2 уменьшает риск дублей на уровне протокола, но дороже и не превращает две разные публикации приложения в одну. Добавьте message ID или sequence в payload и сделайте обработчик идемпотентным там, где повтор вреден.

После нового сеанса повторно подписывайтесь и проверяйте SUBACK, а не считайте вызов subscribe успехом. После продолженной сессии не создавайте параллельные обработчики. Решение определяется Session Present и подтверждениями broker, а не только фактом открытого socket.

Offline-очередь имеет предел и политику

Буфер без лимита съест память при часовом отсутствии сети. Для телеметрии часто можно агрегировать или заменить старое значение новым; для команд нужна строгая очередь, срок жизни и подтверждение. Paho JavaScript документирует disconnected publishing и максимальный размер буфера — настройка должна соответствовать семантике ваших сообщений.

При переполнении не молчите: увеличьте счётчик dropped/coalesced, сохраните причину и покажите состояние синхронизации. После reconnect отправляйте очередь с ограниченной скоростью, иначе восстановление само создаст новый обрыв.

Полевой тест меняет сеть в середине доставки

  1. Подключиться, подписаться и подтвердить контрольное сообщение.
  2. Начать QoS 1 публикацию и выключить сеть до подтверждения.
  3. Переключить Wi‑Fi на мобильную сеть и дождаться единственного reconnect controller.
  4. Проверить CONNACK Session Present, SUBACK при новой сессии и повтор сообщения.
  5. Оставить устройство offline дольше Session Expiry и повторить сценарий как новый сеанс.

Для диагностики нужны версия MQTT и библиотеки, broker, transport, схема Clean Start/Expiry, keep alive, client ID policy, reason codes и график попыток. Payload замените тестовым. Такой набор показывает, проблема в мобильном маршруте, session policy, авторизации или собственной очереди клиента.

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