Perguntas Frequentes
Este capítulo coleta os códigos de erro mais comuns e cenários de exceção encontrados durante o uso do Antigravity Tools, ajudando você a localizar rapidamente a raiz do problema e encontrar soluções.
Conteúdo do Capítulo
| Tipo de Problema | Página | Descrição |
|---|---|---|
| Invalidação de Conta | invalid_grant 与 Desativação Automática de Conta | Conta subitamente indisponível? Entenda causa de expiração do OAuth Token e processo de recuperação |
| Falha de Autenticação | 401/Falha de Autenticação | Solicitação rejeitada? Verifique configuração auth_mode e formato de Header |
| Erros de Limitação | 429/Erro de Capacidade | 429 frequente? Distingua cota insuficiente e limitação de taxa upstream, use estratégia de rotação para reduzir impacto |
| Erros de Rota | 404/Rota Incompatível | Endpoint 404? Resolva problema de concatenação de Base URL e prefixo /v1 |
| Exceções de Fluxo | Interrupção de Fluxo/0 Token/Falha de Assinatura | Resposta interrompida ou vazia? Entenda mecanismo de autocura do proxy e caminho de solução |
Sugestão de Caminho de Aprendizado
Solução por código de erro: ao encontrar erro específico, vá diretamente para página correspondente.
Aprendizado sistemático: se você quer entender totalmente problemas que pode encontrar, recomenda ler na seguinte ordem:
- 404/Rota Incompatível — problema de integração mais comum, geralmente primeira armadilha
- 401/Falha de Autenticação — rota certa mas solicitação rejeitada, verifique configuração de autenticação
- invalid_grant e Desativação Automática de Conta — problema em nível de conta
- 429/Erro de Capacidade — solicitação bem-sucedida mas limitada
- Interrupção de Fluxo/0 Token/Falha de Assinatura — problema avançado, envolve resposta de fluxo e mecanismo de assinatura
Pré-requisitos
Recomendado completar primeiro
- Iniciar Proxy Reverso Local e Conectar Primeiro Cliente — assegurar ambiente básico está rodando
- Adicionar Contas — entender maneira correta de adicionar contas
Próximos Passos
Após solucionar problemas, você pode continuar aprendendo:
- Agendamento de Alta Disponibilidade — usar estratégia de rotação e retry reduzir ocorrência de erros
- Proxy Monitor — usar sistema de logs rastrear detalhes de solicitações
- Configuração Completa — entender todos os itens de configuração