Join our Newsletter — 33% off our NHI Course

MOVED Redirection

MOVED redirection is a Redis Cluster reply that tells a client a key now belongs on a different node. The client must update its slot map and resend the command to the indicated node, which is how the cluster handles resharding and node changes.

How MOVED Redirection Works in Redis Cluster

MOVED redirection is Redis Cluster’s way of telling a client that the slot it targeted is no longer served by the node it contacted. The reply is not an error condition in the usual sense, it is a routing update that points the client to the node that now owns the key’s hash slot.

This behaviour matters because Redis Cluster is designed to rebalance data across nodes while still serving live traffic. When a slot map changes, the client must not keep retrying the old node, it has to refresh its view of the cluster and resend the command to the new destination.

Why MOVED Responses Exist

In a clustered Redis deployment, key placement is determined by hash slots, not by a single fixed server. MOVED responses let the cluster move data and shift ownership without requiring every client to know the topology in advance.

The redirection is especially important during resharding, scaling, failover, and node replacement. Rather than forcing the cluster to proxy every request centrally, Redis pushes the routing decision back to the client so the next request can go directly to the correct node.

That design keeps the cluster lightweight, but it also means client libraries must implement cluster awareness correctly. A client that does not follow MOVED replies will continue talking to the wrong node and see repeated misses or command failures.

Client Behaviour and Slot Map Refresh

When a client receives MOVED, it should update its slot cache or slot map and then retry the command against the address in the reply. Well-behaved cluster clients typically learn from that response and use it to reduce future routing mistakes.

Because the redirected target can change over time, the client’s routing table is only a cache, not a source of truth. Any operational issue that affects node ownership, such as topology churn or a rebalance, can make stale slot information visible until the client learns the new layout.

For applications, this means MOVED handling is part of normal reliability engineering rather than an exceptional edge case. The cluster is signalling, “your map is out of date,” and the client must respond by converging on the current ownership view.

Operational Consequences and Common Failure Modes

Incorrect handling of MOVED redirection can produce noisy retries, elevated latency, and inconsistent application behaviour. If the client library does not refresh its topology knowledge, it may keep sending traffic to a node that no longer owns the slot.

In practice, the biggest failure mode is stale client state after cluster changes. Another common issue is confusing MOVED with transient transport failure: MOVED is a deterministic routing instruction, so the right response is to update routing state, not to blindly retry the same endpoint.

At scale, this can become a resilience issue because a poorly implemented client can amplify a routine resharding event into a visible application incident. The cluster may be healthy, but the application still appears broken because its routing logic has not caught up.

Risk and Threat Considerations

MOVED redirection is operationally safe when clients trust the cluster topology and update their slot map correctly, but the same mechanism can expose routing instability if client implementations are brittle. The main risk is not data loss from the redirect itself, it is stale or incorrect client routing during cluster churn, failover, or resharding.

Failure mechanism: A client continues using an outdated slot map, repeatedly targets the wrong node, and turns a normal ownership change into avoidable retry storms, latency spikes, or command failures.

Impact: Applications can see degraded availability, inconsistent performance, and operational noise that obscures the real state of the cluster.

Standards & Framework Alignment

This section maps relevant standards and security frameworks to the operational risks and controls described in this guidance.

NIST SP 800-53 Rev 5, CIS Controls v8 and NIST CSF 2.0 set the governance and control requirements practitioners need to meet.

Framework Control / Reference Relevance
NIST SP 800-53 Rev 5 AC-4 — Information Flow Enforcement Redis Cluster redirection enforces where requests are routed across nodes.
CM-8 — System Component Inventory Slot-map refresh depends on knowing current cluster node ownership and topology.
Recommendation — Enforce routing rules so clients only send commands to the node that owns the slot. Maintain an accurate inventory of cluster nodes and ownership so clients can refresh routing state.
CIS Controls v8 CIS-12 — Network Infrastructure Management Cluster node changes and redirection behaviour are part of managed networked infrastructure.
Recommendation — Document and monitor cluster topology changes so redirection events are handled cleanly.
NIST CSF 2.0 PR.AA-05 — Identity Management, Authentication, and Access Control Client redirection depends on sending requests to the correct trusted service endpoint.
Recommendation — Restrict client access to the correct Redis nodes and validate endpoint targeting on redirects.

Practitioner Guidance

What to watch for: Treat MOVED handling as a required capability in every Redis Cluster client you deploy. The client should cache topology intelligently, refresh it on redirection, and distinguish MOVED from transient network errors so routing updates happen promptly and predictably.

Practitioner takeaway: The reliability of a Redis Cluster depends as much on client-side redirection logic as it does on the cluster nodes themselves.