Todos os produtos
Search
Central de documentação

Tair (Redis® OSS-Compatible):O que fazer quando o erro "WRONGPASS invalid username-password pair" ocorre ao conectar a uma instância Redis Open-Source Edition

Última atualização: Jun 26, 2026

O erro WRONGPASS invalid username-password pair indica nome de usuário, senha ou formato de credencial incorreto ao conectar a uma instância Redis Open-Source Edition 6.0 ou 5.0 (versão secundária 5.0.8 e posteriores).

Solução

Esse erro ocorre quando as credenciais fornecidas não correspondem ao que o servidor espera — seja um valor incorreto ou um formato inadequado para o tipo de conta utilizado.

Acesse a página de detalhes da instância e clique em Account Management no painel de navegação à esquerda para verificar o tipo de conta. Caso tenha esquecido a senha, clique em Reset Password na coluna Actions correspondente à conta.

Use o formato de conexão compatível com o tipo de conta:

  • Conta padrão: insira apenas a senha.

    redis-cli -h <host> -p <port> -a <password>
  • Conta padrão estendida: insira as credenciais no formato <account>:<password>. Por exemplo, para a conta testaccount com a senha Rp829dlwa, a string de credencial é testaccount:Rp829dlwa.

    Exemplo de comando:

    redis-cli -h <host> -p <port> -a testaccount:Rp829dlwa

Outros cenários de conexão

  • Ferramentas de terceiros, como o RDM:

    Insira a string completa <account>:<password> diretamente no campo de senha.

  • Acesso sem senha com credenciais incorretas:

    Quando o acesso sem senha está ativado em uma instância Redis 6.0, o servidor ainda valida qualquer credencial fornecida explicitamente. Informar credenciais incorretas aciona o erro WRONGPASS. O servidor permite conexões não autenticadas, mas rejeita as inválidas. Forneça as credenciais corretas ou omita-as por completo.

  • Conexões via URI com caracteres especiais:

    Ao conectar por URI, como redis-cli -u redis://<account>:<password>@<host>:<port>/<db>, aplique a codificação de URL nos caracteres especiais da senha. Codificações mais comuns:

    # Example for account 'testaccount' with password 'my@password'
    # The '@' character must be encoded as %40
    redis-cli -u redis://testaccount:my%40password@<host>:<port>/<db>

    Caractere

    Forma codificada

    @

    %40

    #

    %23

    !

    %21

    $

    %24

    %

    %25

    &

    %26

    /

    %2F

    :

    %3A