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 доходит до приложения | Режим и возможности клиента | Ключ повреждён |
| Перенаправление есть, соединения нет | Объявленный адрес из сети клиента | Все узлы кластера недоступны |
| Ошибка только при миграции слота | Обработку ASK | ASK равен постоянному MOVED |
| Часть ключей работает | Разные владельцы слотов | Один успешный ключ доказывает всю топологию |
Сеть клиента проверяется до повторов
Сравните, какие адреса возвращает кластер и какие реально доступны приложению: DNS, порт, TLS и необходимые правила доступа. Проверка с административного хоста не заменяет проверку из окружения клиента. Не публикуйте полный список внутренних узлов в открытом тикете; для воспроизведения достаточно обезличенной схемы и типа ошибки соединения.
Обычный балансировщик перед одним адресом не обязательно обеспечивает маршрутизацию Redis Cluster. После первого соединения библиотека может обращаться к объявленным владельцам слотов напрямую. Если используется совместимый прокси или управляемый endpoint, его договор проверяется отдельно. Не меняйте объявленные адреса на рабочем кластере без плана для остальных клиентов.
Отдельно проверьте операции с несколькими ключами и используемые транзакции по документации своей библиотеки. Исправление MOVED не делает любую многоключевую команду допустимой. Не сводите все ключи в один слот ради устранения ошибок: это способно изменить распределение нагрузки и требует отдельного архитектурного решения.
Приёмка переживает изменение карты
- Чтение и запись искусственных ключей разных слотов.
- Доступ ко всем требуемым объявленным адресам.
- Контролируемая миграция слота на стенде.
- Переподключение с повторным обнаружением топологии.
- Ограниченный исход при недоступном владельце.
Перенаправление и неизвестный результат изменяющей операции — разные случаи. После сетевого тайм-аута нельзя автоматически считать действие неисполненным и повторять внешнюю бизнес-операцию под новым ID. Сохраните предусмотренный способ выяснения исхода. Для разбора подготовьте версию библиотеки, режим подключения и искусственную трассу одного перенаправления: по ней видно, проблема в протоколе клиента или в достижимости адресата.