ERR FAILOVER requires connected replicas.: FAILOVER requires connected replicas

O que significa?

FAILOVER foi executado para iniciar um failover coordenado (graceful), mas foi rejeitado porque não há uma réplica adequada conectada ao primário disponível para assumir. O failover não pode acontecer sem um destino para o qual passar o papel.

Por que acontece?

O primário não tem réplicas conectadas no momento (as réplicas estão fora do ar, desconectadas da rede ou fora de sincronia), ou a réplica de destino especificada não é elegível/não está conectada. Quando o FAILOVER manual (Redis 6.2+) é chamado, a topologia de replicação não atende à condição exigida. Observação: o FAILOVER funciona apenas com replicação standalone (master/replica); no Redis Cluster, usa-se CLUSTER FAILOVER na réplica.

Como resolver

Garanta que exista pelo menos uma réplica saudável, conectada e atualizada (verifique connected_slaves e o status de sincronização com INFO replication). Corrija problemas de rede/acesso nas réplicas para que se conectem ao primário. Para fazer failover para um destino específico, use FAILOVER TO host port e verifique se essa réplica é elegível.