Когда одно задание одновременно выполняют несколько серверов, начните с его пути доставки. Для Redis Streams разные consumer groups читают поток независимо: если каждый сервер создаёт собственную группу, вы могли настроить рассылку всем вместо распределения работы. На стенде отправьте один искусственный элемент и сопоставьте его ID, имя группы и имя потребителя на каждом сервере.

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

Три вида повтора оставляют разные следы

НаблюдениеЧто это означаетКуда смотреть
Разные stream ID, одна бизнес-операцияПовтор у источника или постановкиProducer и идентификатор операции
Один stream ID, разные группыНезависимое чтение группамиТопология подписки
Один ID в одной группе повторноПовторная обработка незавершённой работыПодтверждение и восстановление consumer

Официальное описание XREADGROUP различает consumer group и consumer внутри неё. Группа позволяет разделять чтение между потребителями, а несколько групп имеют собственное состояние потребления. Проверено 15 октября 2026 года. Имя сервера обычно полезно для различения потребителей одной роли, но превращать его в отдельную группу для той же общей работы нужно только при осознанной рассылке.

Имя группы описывает обязанность

Условная топология одного потока:
group: invoice-workers
  consumer: worker-A
  consumer: worker-B

group: audit-projector
  consumer: audit-A

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

В этом условном примере аудит и выставление документа — разные обязанности, поэтому независимые группы оправданы. Если оба экземпляра invoice-worker должны делить одну очередь, проверьте, что они используют одну предусмотренную группу и различные идентичности потребителей. Сверяйте фактическую конфигурацию процесса после деплоя: значение по умолчанию, включающее hostname, способно создавать новую группу на каждом запуске.

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

Распределение чтения не равно однократному эффекту

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

  1. Опубликовать один тестовый элемент и записать его ID.
  2. Запустить два consumer одной роли и сопоставить группу.
  3. Добавить независимую тестовую группу и увидеть осознанный fan-out.
  4. Остановить обработчик до подтверждения и испытать восстановление.
  5. Повторить завершённую бизнес-операцию и проверить отсутствие второго эффекта.

Во время испытаний не отправляйте реальные письма, списания или документы: используйте изолированные приёмники. Подтверждать элемент до сохранённого результата ради устранения повторов нельзя — так появляется потеря работы. При откате топологии остановите конкурирующих писателей результата и учтите обработанное после изменения. Для расследования достаточно схемы групп и потребителей, безопасного ID тестового элемента и времён запуска, эффекта и подтверждения; содержимое рабочих сообщений не требуется.

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