Зелёный индикатор соединения говорит лишь о том, что транспорт сейчас доступен. Он не доказывает, что конкретное сообщение записано сервером, дошло до телефона адресата или было открыто человеком. Ошибка интерфейса обычно начинается с одного булева `delivered`, в который попытались уместить все эти события.

Socket.IO гарантирует порядок сообщений, но по умолчанию описывает доставку как at-most-once: при разрыве во время отправки событие может не попасть на другую сторону, а сервер без дополнительной логики не хранит пропущенные события для отключённого клиента. Значит, гарантию надо строить в приложении поверх транспорта.

Назовите четыре состояния без двусмысленности

СостояниеКто подтверждаетЧто уже известно
queuedустройство отправителясообщение сохранено локально
acceptedсервер после commitесть message ID и запись
deliveredконкретное устройство адресаталокальный inbox принял запись
readклиент после показа пользователюсообщение было в видимой области
failedклиент/сервер по политикедальнейший retry требует решения

Названия можно изменить, но их смысл фиксируется в API и аналитике. Если продукт показывает одну галочку, решите, какое именно состояние она означает, и не поднимайте её по событию подключения сокета.

Accepted появляется только после сохранения

client_message_id: 01J...
conversation_id: c-42
sender_id: u-7
body: ...
created_at_client: ...

server response: {message_id, sequence, state: 'accepted'}

Клиентский ID остаётся тем же при retry. Сервер делает его уникальным в пределах отправителя или беседы, записывает сообщение и только после commit отправляет ack. Если ответ потерялся, повтор возвращает уже созданный `message_id`, а не публикует вторую копию.

Delivered привязывается к устройству

У пользователя могут быть телефон, браузер и офлайн-планшет. Событие `delivered` должно содержать device/session ID и sequence сообщения. Продуктовая агрегация — «хотя бы одно устройство» или «все активные устройства» — выбирается отдельно. Удалённое или давно неактивное устройство не должно навсегда блокировать общий статус.

  • Сохранить сообщение в локальное хранилище до device ack.
  • Не считать push-уведомление подтверждением чтения.
  • Не доверять read-событию от пользователя без доступа к беседе.
  • Хранить время сервера и sequence, а клиентское время использовать как подсказку.
  • Агрегировать состояния по документированному правилу устройств.

Reconnect начинается с последнего offset

Клиент сохраняет последний непрерывно обработанный sequence/offset. После reconnect он отправляет его серверу; сервер читает из устойчивого event store все более новые события и только затем переключает сессию на live. Именно такой подход Socket.IO приводит как способ получить доставку server-to-client не хуже at-least-once.

connect({ auth: { offset: lastAppliedSequence } })
server: SELECT * FROM conversation_events
        WHERE sequence > :offset ORDER BY sequence
client: apply idempotently, then advance contiguous offset

Если сначала подписаться на live, а потом читать историю без барьера, новое событие может прийти между двумя этапами и появиться дважды или потеряться. Сделайте replay и live одной согласованной процедурой, а применение на клиенте — идемпотентным по event ID.

Поздний ack не откатывает состояние

Подтверждения могут прийти повторно и не по ожидаемому времени: старый браузер проснулся после того, как телефон уже отправил read. Применяйте только монотонные переходы `accepted < delivered < read`; старое событие сохраняйте в диагностике, но не понижайте отображаемое состояние. Для отзыва или удаления заведите отдельное событие, а не обратный статус доставки.

Тестируйте разрывы в каждом промежутке

  1. Оборвать сеть до server commit: сообщение остаётся queued и повторяется с тем же ID.
  2. Оборвать после commit, но до ack: retry возвращает ту же серверную запись.
  3. Доставить событие устройству и потерять device ack: replay не создаёт дубль.
  4. Прочитать на телефоне при выключенном браузере: общий read не откатывается после его reconnect.
  5. Получить события 12 и 14 без 13: непрерывный offset не перескакивает через пробел.
  6. Открыть беседу двумя вкладками: аналитика не считает два прочтения одним пользователем.

Лог описывает путь одного message ID

Для диагностики достаточно message ID, conversation ID, server sequence, session/device ID, типа ack, времени сервера и correlation ID соединения. Текст сообщения и токен авторизации в технический лог не кладите. По этой цепочке видно, кто именно заявил неверное состояние.

Подготовьте для разбора один обезличенный timeline от queued до read, версии клиента и сервера, правила агрегации устройств и результат reconnect с offset. Скриншот одной галочки без событий не позволяет отличить UI-кеш от потери транспорта.

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