Новое соединение gRPC не продолжает прикладную последовательность с нужного места само по себе. Для восстанавливаемого потока договоритесь о курсоре возобновления и сохраняйте его после подтверждённой обработки сообщения. Сначала воспроизведите разрыв на тестовом потоке с различимыми идентификаторами событий.

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

Retry вызова и продолжение истории — разные механизмы

Официальный gRPC Retry guide, проверенный 4 ноября 2026 года, описывает повтор как новый вызов с воспроизведением сохранённой истории. После получения response headers RPC считается committed, и дальнейший встроенный retry не выполняется. Нельзя рассчитывать, что он восстановит уже читаемый длительный поток с последнего бизнес-события.

Прикладной протокол может принимать resume token или позицию. Их смысл задаёт ваш сервер: следующий элемент после курсора либо включительно последний элемент. Выберите одну семантику и проверьте её на границе. Если сервер возвращает последний элемент повторно, клиент должен распознать его по устойчивому ID.

Момент отказаРиск
До примененияПотеря при раннем checkpoint
После примененияПовтор эффекта
Курсор устарелНужна повторная синхронизация
Сменился фильтрПозиция может относиться к иной выборке

Сравните три наблюдения: received, applied и checkpoint. Первое означает получение, второе — завершённый эффект в вашей системе, третье — сохранённую позицию возобновления. Они могут происходить в разных компонентах. Общий счётчик «получено сообщений» не подтверждает, что последовательность обработана без дыр.

Курсор связан с выборкой и её сроком жизни

Условная последовательность:
received E42
applied E42
checkpoint E42
reconnect: resume after E42
При повторе E42 эффект проверяется по устойчивому ID.

Сохраните вместе с позицией идентичность потока: tenant, фильтр, версию протокола и выбранный порядок. Курсор для одного клиента нельзя принимать как разрешение читать другого. На новом RPC сервер заново проверяет авторизацию и допустимость позиции, даже если token выглядит корректным.

Определите поведение, когда история уже удалена или курсор больше не поддерживается. Без явного ответа клиент способен бесконечно повторять невозможное продолжение. Предусмотрите повторную синхронизацию снимка и границу последующего чтения; способ их согласования зависит от модели хранения событий и должен иметь собственный тест.

Условный сценарий: клиент применил событие E42, но не успел записать checkpoint. После перезапуска сервер присылает E42 снова. Если эффект защищён уникальным ID события, повтор не меняет итог, а позиция продвигается. Без такой защиты повторное соединение может удвоить начисление или создание записи.

Разрыв проверяют между этапами, а не только до соединения

На тестовых данных остановите клиента до применения события, после применения и до checkpoint. В каждом прогоне сверяйте конечное состояние и перечень обработанных ID. Успешное восстановление TCP не является критерием: важен итог бизнес-операций и отсутствие пропущенных событий.

Ограничьте частоту повторных соединений и общий бюджет восстановления. Временная недоступность сервера не должна создавать плотный цикл запросов. Отличайте сетевой отказ от запрета доступа и недействительного курсора: последние требуют другого действия, а не бессрочного повтора с теми же параметрами.

Для двунаправленного потока отдельно решите судьбу отправленных команд. Подтверждённое получение входящего события не доказывает выполнение исходящей команды. Сохраните идентификаторы операций и проверяйте неизвестный исход по своему протоколу, прежде чем отправлять изменение повторно.

  1. Определить смысл курсора и порядок сообщений.
  2. Связать checkpoint с подтверждённым эффектом.
  3. Прервать тест между этапами обработки.
  4. Сверить итог и поведение при устаревшей позиции.

Подготовьте для разбора безопасную трассу: ID попытки, ID события, received/applied/checkpoint, код завершения RPC и выбранную позицию восстановления. Содержимое сообщений и секретный resume token можно исключить. Приёмка завершена, когда каждый искусственный разрыв приводит к одному объяснимому результату данных, а не только к возобновлённому потоку на экране.

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