MOVED в Redis Cluster означает, что ключ обслуживает другой узел: ответ сообщает слот и адрес назначения. Это не повод перемещать ключ вручную или отключать кластер. Сначала проверьте, использует ли приложение клиент с поддержкой Cluster и может ли оно достичь адреса, указанного в перенаправлении, из своей сети.

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

Первое соединение не задаёт маршрут всех ключей

Условная трасса обращения:
seed_endpoint: <начальная точка>
key: <искусственный ключ>
redirect_kind: MOVED / ASK
slot: <из ответа>
announced_endpoint: <без credentials>
reachable_from_client: yes / no

Спецификация Redis Cluster описывает MOVED как перенаправление к владельцу слота, которое клиент учитывает в карте маршрутов. ASK относится только к следующему перенаправленному запросу при миграции и требует предусмотренного протокола ASKING, без преждевременного постоянного изменения карты. Проверено 15 октября 2026 года. Реализацию этих деталей обычно поручают поддерживающей Cluster библиотеке.

СимптомЧто проверитьНеверный вывод
Любой MOVED доходит до приложенияРежим и возможности клиентаКлюч повреждён
Перенаправление есть, соединения нетОбъявленный адрес из сети клиентаВсе узлы кластера недоступны
Ошибка только при миграции слотаОбработку ASKASK равен постоянному MOVED
Часть ключей работаетРазные владельцы слотовОдин успешный ключ доказывает всю топологию

Сеть клиента проверяется до повторов

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

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

Отдельно проверьте операции с несколькими ключами и используемые транзакции по документации своей библиотеки. Исправление MOVED не делает любую многоключевую команду допустимой. Не сводите все ключи в один слот ради устранения ошибок: это способно изменить распределение нагрузки и требует отдельного архитектурного решения.

Приёмка переживает изменение карты

  • Чтение и запись искусственных ключей разных слотов.
  • Доступ ко всем требуемым объявленным адресам.
  • Контролируемая миграция слота на стенде.
  • Переподключение с повторным обнаружением топологии.
  • Ограниченный исход при недоступном владельце.

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

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