E · Erro
Estruturarefresh
Resposta quando uma requisição não pode ser processada. O texto reason ocupa o lugar da key. A key não é ecoada, então um quadro sozinho não identifica qual requisição em pipeline falhou. Por isso todo E é connection-fatal. O servidor faz flush de E quando possível e fecha; os clientes oficiais também descartam a sessão. Todo acquire com ao menos um byte enviado e sem resposta definitiva termina Indeterminate, nunca como sucesso ou falha presumida.
| reason | causa | conexão |
|---|---|---|
auth_failed | incompatibilidade no digest do handshake de autenticação | fechada |
bad_op | código de op desconhecido | fechada |
bad_request | header fixo curto (10 bytes para A, 8 para R) | fechada |
bad_lease | lease é 0 ou 251..255 | fechada |
bad_key | chave ausente / excede 128B / contém espaço ou nova linha / não é UTF-8 | fechada |
line_too_long | quadro excede 192B | fechada |
no_leader | (cluster) líder atualmente desconhecido — eleição em andamento; tente novamente em breve | fechada |
not_active | o nó não pode atender — está sendo desligado | fechada |
- Estes oito motivos são a lista completa e todos fecham a conexão. Um cliente raw pode diagnosticar, mas não deve ressincronizar ou reutilizar o stream.
- Clientes oficiais validam key e tempos antes do envio;
bad_*não é resultado normal da API. no_leaderenot_activesão temporários, masEnão carrega owner/key. Descarte a sessão; só requisições ainda não enviadas podem ser tentadas em outra. Nunca reenvie automaticamente acquire enviado.M,L,no_leaderenot_activesó aparecem em cluster.- Capacidade cheia retorna
B(ocupado), nãoE, pois ecoa owner e key.
Notação de bytes:
opé um caractere ASCII, ereasoné texto ASCII (comprimento variável, mostrado comoNna estrutura). O\nfinal é0A.
Fluxo
Cliente
Servidor
quadro inválido (ex.: >192B)
E · line_too_long
flush de E e fechamento
todo acquire enviado fica Indeterminate
requisiçãoresposta
E permite observar diagnóstico, mas nunca reutilizar o stream com segurança. Rejeição recuperável de capacidade usa B (ocupado), que ecoa owner e key.