Когда одно задание одновременно выполняют несколько серверов, начните с его пути доставки. Для 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, способно создавать новую группу на каждом запуске.
Изменение имени группы не переносит её историю автоматически. При переключении нужно определить, какие элементы уже дали бизнес-результат, какие ожидают подтверждения и от какой позиции начинается чтение. Не удаляйте старую группу ради красивого списка: это может уничтожить полезный учёт незавершённой работы. Сначала сохраните состояние и согласуйте обращение с каждым классом элементов.
Распределение чтения не равно однократному эффекту
Даже правильная общая группа не отменяет сбой между сохранением результата и подтверждением элемента. Повтор может быть необходим для восстановления. Поэтому исполнитель различает стабильный идентификатор бизнес-операции и конкретную доставку, а повторный запуск не должен снова создавать уже завершённый эффект. Для внешнего сервиса используйте предусмотренную им идемпотентность либо собственный согласованный протокол сверки результата.
- Опубликовать один тестовый элемент и записать его ID.
- Запустить два consumer одной роли и сопоставить группу.
- Добавить независимую тестовую группу и увидеть осознанный fan-out.
- Остановить обработчик до подтверждения и испытать восстановление.
- Повторить завершённую бизнес-операцию и проверить отсутствие второго эффекта.
Во время испытаний не отправляйте реальные письма, списания или документы: используйте изолированные приёмники. Подтверждать элемент до сохранённого результата ради устранения повторов нельзя — так появляется потеря работы. При откате топологии остановите конкурирующих писателей результата и учтите обработанное после изменения. Для расследования достаточно схемы групп и потребителей, безопасного ID тестового элемента и времён запуска, эффекта и подтверждения; содержимое рабочих сообщений не требуется.