O que significam realmente 403, 404, 500, 502, 503 e 504 nesta plataforma, e o que fazer especificamente em cada caso.
Um código de erro não é uma mensagem de falha genérica. Diz-lhe qual a camada da pilha que desistiu, e isso delimita enormemente a causa. Um 502 e um 504 parecem idênticos para um visitante, mas têm causas e soluções completamente diferentes.
A Ler o Código Real
Antes de resolver o problema, obtenha o número real. Uma página de erro bonita pode dizer uma coisa enquanto o servidor devolve outra.
No seu navegador, abra as ferramentas de programador, vá ao separador Network, recarregue a página e clique no primeiro pedido. O estado encontra-se no topo do painel Headers.
A partir de um terminal:
curl -sSI https://yourdomain.com/
Isto imprime a linha de estado e os cabeçalhos da resposta sem transferir a página. Os cabeçalhos são importantes: vários dos casos abaixo são identificados por um cabeçalho em vez de apenas pelo código.
A Versão Resumida
| Código | Significado | Problema de quem |
|---|---|---|
| 401 | Autenticação necessária | A proteção por palavra-passe está ativa |
| 403 | Recusado propositadamente | Uma regra de segurança bloqueou o pedido |
| 404 | Não encontrado | O seu site, normalmente o encaminhamento |
| 500 | A sua aplicação falhou | O seu código ou um plugin |
| 502 | O servidor atrás do servidor web falhou | Normalmente a sua aplicação |
| 503 | Deliberadamente sem resposta neste momento | Suspenso, em pausa ou em manutenção |
| 504 | Demorou demasiado tempo | Algo no seu código está lento |
401 Unauthorized
Verá uma caixa de nome de utilizador e palavra-passe do navegador em vez de uma página. Isso significa que a proteção por palavra-passe básica está ativada no site ou nesse caminho.
Desligue-a, ou obtenha as credenciais, em Websites, o site, Definições, depois Proteção por palavra-passe. Consulte Proteção por Palavra-Passe.
A renovação do certificado continua a funcionar enquanto a proteção por palavra-passe estiver ativa, pelo que isto não irá quebrar o seu HTTPS.
403 Forbidden
403 significa que algo recusou deliberadamente o pedido. Nesta plataforma existem quatro origens distintas.
A firewall de aplicações web. Todos os sites estão atrás de um motor de regras que inspeciona os pedidos recebidos e bloqueia os que correspondem a padrões de ataque conhecidos. Esta é a origem mais comum de um 403 inesperado, e é quase sempre um falso positivo numa solicitação legítima mas invulgar: um envio de formulário longo, um construtor de páginas a guardar conteúdo complexo, um plugin a enviar código em bruto.
Sintomas de um bloqueio da firewall: uma ação específica falha sempre com 403 enquanto o resto do site funciona normalmente, e falha de forma idêntica noutro navegador e noutra rede.
A solução é uma exclusão de regra específica, que o suporte pode adicionar. Não procure um interruptor para desligar a firewall; não existe um para alojamento partilhado, e seria a solução errada de qualquer forma. Abra um pedido de suporte com o URL exato, a hora exata e o que estava a fazer. Consulte Abrir um Pedido de Suporte.
Bloqueio geográfico. Se restringiu o seu site a determinados países, todos os outros recebem um 403. Verifique Definições, depois Segurança. Consulte Bloqueio Geográfico.
Um bloqueio de IP. Quer tenha adicionado um você mesmo em Security, quer seja um bloqueio de abuso ao nível da plataforma.
Um problema de permissões de ficheiros ou de symlink. Menos comum, e normalmente surge após uma operação manual de ficheiros via SSH.
404 Not Found
O servidor respondeu, mas não há nada nesse endereço.
Uma página dá 404. O ficheiro ou a publicação genuinamente não existe, ou o URL está errado.
Todas as páginas exceto a página inicial dão 404. Este é um problema de encaminhamento, e no WordPress é quase sempre a questão dos permalinks. Importante: o alojamento web da KapsuleHost utiliza nginx, não Apache, pelo que as regras de reescrita do .htaccess não têm qualquer efeito aqui. Se migrou de um alojamento que as utilizava, essa é a sua causa. Consulte Problemas com Permalinks e WordPress e .htaccess.
Todo o site dá 404. Verifique se o site está apontado para a raiz de documentos correta e se o seu domínio está associado ao site correto. Consulte Domínio Personalizado para um Website.
Funciona na sua máquina mas dá 404 em produção. Os nomes de ficheiros em Linux são sensíveis a maiúsculas e minúsculas. Logo.PNG e logo.png são dois ficheiros diferentes.
500 Internal Server Error
A sua aplicação foi executada e falhou. O servidor web está bem; o código não está.
Este é o caso em que os registos lhe dão a resposta quase de imediato, porque um erro fatal de PHP regista o ficheiro e o número da linha que falhou, o que normalmente identifica o plugin exato.
- Vá a Websites, o site, Definições, depois Registos.
- Veja as entradas mais recentes.
- Faça corresponder a hora ao momento em que viu o erro.
Consulte Registos de Erro. Para a versão específica do WordPress disto, em que a página fica em branco em vez de mostrar um erro, consulte O Ecrã Branco do WordPress.
As causas mais comuns são um plugin ou tema incompatível com a sua versão de PHP, um limite de memória atingido e uma falha na ligação à base de dados. Consulte Extensões e Definições do PHP e Limite de Memória do WordPress.
502 Bad Gateway
O servidor web tentou entregar o pedido à sua aplicação e não obteve nada utilizável de volta. O processo da aplicação recusou a ligação ou morreu a meio do pedido.
Causas comuns:
- Um processo PHP falhou, muitas vezes por ter esgotado a memória num único pedido.
- Uma aplicação Node.js não está em execução, ou falhou no arranque.
- Um pico de tráfego esgotou os processos de trabalho disponíveis.
O que fazer: verifique primeiro os registos, como acima. Se for uma aplicação Node, verifique se o processo está realmente ativo e veja o seu resultado de arranque. Se os 502 aparecerem apenas nos seus períodos de maior movimento, trata-se de um problema de capacidade e não de um erro de código. Consulte Lentidão do Site e Limites de Recursos.
Um 502 vindo do próprio KPanel, ao guardar uma definição, significa algo diferente. Significa que o painel não conseguiu aplicar a alteração de configuração ao servidor web, e reverteu a alteração em vez de deixar o seu site parcialmente configurado. O seu website não é afetado. Tente novamente, e se continuar a falhar, abra um pedido de suporte.
503 Service Unavailable
503 significa que o servidor deliberadamente não está a responder neste momento. Existem três causas específicas nesta plataforma, e a resposta indica qual delas é.
O seu site está suspenso. Verá uma página com o título "This site is paused". Isto é um estado de faturação ou de conta, não uma falha técnica, e o site volta imediatamente assim que o estado for resolvido. Verifique Faturação. Consulte Pagamento Falhado e Conta Suspensa.
Manutenção da plataforma. Uma página de manutenção de toda a plataforma, o que é raro e anunciado previamente. Consulte Estado e Disponibilidade.
504 Gateway Timeout
A sua aplicação ainda estava a funcionar quando o servidor web esgotou a paciência. Nada falhou. Estava simplesmente demasiado lento.
Causas típicas:
- Uma importação, exportação, cópia de segurança ou operação em massa de longa duração executada através do navegador.
- Um plugin a chamar uma API externa lenta em cada carregamento de página.
- Uma consulta à base de dados dispendiosa sem um índice por trás.
- Uma tarefa cron a ser acionada por uma visualização de página em vez de por um cron real.
O que fazer:
- Identifique qual o pedido que está lento. O separador APM em sites WordPress mostra-lhe isso. Consulte Desempenho do Site.
- Para operações longas, utilize a linha de comandos em vez do navegador. Consulte WP-CLI.
- Mova o trabalho agendado para um cron real. Consulte Tarefas Cron.
- Aumente
max_execution_timese o trabalho genuinamente precisar de mais tempo, embora isto seja uma solução de contorno e não uma correção. Consulte Extensões e Definições do PHP.
Note a diferença: se o PHP atingir primeiro o seu próprio limite de execução, obtém um 500, não um 504. Ambos significam "demasiado lento", em camadas diferentes.
Nenhuma Resposta
Por vezes não há código de erro algum, porque não há resposta. A ligação simplesmente fica suspensa e acaba por expirar.
Se isso acontecer numa rede mas o site funcionar noutra, especialmente num telemóvel com dados móveis, a causa mais provável é um bloqueio automático de abuso: um pico de erros ou de tentativas de início de sessão falhadas a partir do seu endereço desencadeou um banimento temporário ao nível da rede. Estes resolvem-se por si próprios, normalmente dentro de uma hora. Se precisar que seja levantado mais cedo, contacte o suporte com o endereço IP a partir do qual está a ligar-se.
Páginas de Erro Personalizadas
Pode substituir a página de erro predefinida para 400, 401, 403, 404, 500, 502, 503 e 504 pelo seu próprio HTML, em Websites, o site, Definições, depois Páginas de erro. A KapsuleHost fornece predefinições de marca para 404, 500, 502, 503 e 504 caso não o faça.
Uma coisa que vale a pena saber: uma página de erro personalizada mantém o código de estado real. Um 404 personalizado continua a devolver 404. Servir a sua página de erro com um estado 200 é uma forma clássica de destruir a sua classificação nos motores de busca, e isso é deliberadamente impossível aqui. Consulte Páginas de Erro Personalizadas.