Ridge Solução de problemas

Diagnosticar do limite mais externo para dentro: serviço, transporte, sessão, catálogo, SQL, transação e, em seguida, armazenamento. Preserve o primeiro erro estruturado e SQLSTATE.

O serviço não está disponível

systemctl status ridged.service
pg_isready -h 127.0.0.1 -p 7898 -d ridge

Confirme a porta configurada, o prefixo de dados, as permissões, as bibliotecas de tempo de execução, os arquivos TLS e se o ouvinte permanece em loopback. Execute ridged --check antes de iniciar um binário empacotado.

A inicialização ou a negociação TLS falham

Verifique se o certificado e a chave estão configurados, legíveis apenas pela identidade do serviço e se correspondem. A autenticação de senha Ridge é aceita apenas dentro do caminho TLS configurado. Verifique o modo TLS do cliente e evite assumir SCRAM PostgreSQL ou mapeamento de usuário de certificado.

SQL foi rejeitado

Use a mensagem estruturada e SQLSTATE. Verifique:

• uma instrução limitada ou modo de execução compatível;
• identificadores sem aspas em letras minúsculas;
• as formas exatas de SQL em grove/libs/ridge_sql/README.md;
• Ridge SHOW introspecção em vez de PostgreSQL catálogos;
• tipos de parâmetros e limites de resultados;
• estado da transação após um erro anterior.

Uma resposta explícita sem suporte não é evidência de corrupção de armazenamento.

Uma gravação desconectada

Não repita. O servidor pode ter confirmado antes da perda da resposta. Reconecte, inspecione o alvo por sua chave primária ou de idempotência e decida a próxima ação a partir do estado observado. Ridge Admin rotula esse resultado como uncertain.

Conflito de bloqueio ou serialização

SQLSTATE 55P03 indica contenção de bloqueio limitado. Os conflitos de transação também podem surgir da validação de cabeçalho esperado ou de chave exclusiva. Reverta a transação com falha, atualize o estado e tente novamente somente quando a operação do aplicativo for segura e limitada.

Ridge Admin não tem local Ridge

Confirme se o binário atual do contrato 3 está em execução, se seu armazenamento de perfil pode ser gravado com o modo 0600 e se ridged aceita conexões em 127.0.0.1:7898. Reinicie Ridge Admin após substituir o binário; tokens de inicialização e sessões são intencionalmente invalidados na reinicialização.

Possíveis danos de armazenamento

Interrompa mutações, preserve logs e caminhos exatos, verifique o espaço em disco disponível e execute a verificação integrity/backup compatível. Restaure para um novo destino e valide-o antes da transição. Nunca repare arquivos B+Tree, WAL, catálogo, índice ou versão com um editor de arquivos geral.