Códigos de Erro HTTP no KapsuleHost

What 403, 404, 500, 502, 503 and 504 actually mean on this platform, and the specific thing to do about each one.

Códigos de erro HTTP na KapsuleHost

O que 403, 404, 500, 502, 503 e 504 realmente significam nesta plataforma, e o que fazer especificamente em cada caso.

Um código de erro não é uma mensagem genérica de falha. Indica qual camada da stack desistiu, e isso reduz enormemente as causas possíveis. Um 502 e um 504 parecem idênticos a um visitante mas têm causas e soluções completamente diferentes.

Ler o Código Real

Antes de resolver problemas, 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 desenvolvedor, vá para o separador Rede, recarregue a página e clique no primeiro pedido. O estado está no topo do painel Cabeçalhos.

A partir de um terminal:

curl -sSI https://yourdomain.com/

Isto imprime a linha de estado e os cabeçalhos da resposta sem descarregar 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	Responsabilidade
401	Autenticação obrigatória	Proteção por palavra-passe ativada
403	Recusado propositadamente	Uma regra de segurança bloqueou o pedido
404	Não encontrado	O seu site, geralmente encaminhamento
500	A sua aplicação falhou	O seu código ou um plugin
502	O servidor atrás do servidor web falhou	Geralmente a sua aplicação
503	Deliberadamente não está servindo neste momento	Suspenso, pausado ou manutenção
504	Demorou demasiado tempo	Algo no seu código é lento

401 Não Autorizado

Verá uma caixa de nome de utilizador e palavra-passe do navegador em vez de uma página. Isto significa que a proteção por palavra-passe básica está ativada no site ou nesse caminho.

Desative-a ou obtenha as credenciais em Websites, o site, Advanced, depois Password protection. Consulte Proteção por Palavra-passe.

A renovação de certificados continua a funcionar com a proteção por palavra-passe ativada, portanto isto não prejudicará o seu HTTPS.

403 Proibido

403 significa que algo deliberadamente recusou o pedido. Nesta plataforma existem quatro fontes distintas.

A firewall de aplicação web. Cada site está atrás de um motor de regras que inspeciona pedidos recebidos e bloqueia aqueles que correspondem a padrões de ataque conhecidos. Esta é a fonte mais comum de um 403 inesperado, e é quase sempre um falso positivo num pedido legítimo mas invulgar: um envio de formulário longo, um construtor de páginas guardando conteúdo complexo, um plugin enviando código bruto.

Sintomas de um bloqueio de firewall: uma ação específica falha com 403 sempre que enquanto o resto do site funciona bem, e falha de forma idêntica num navegador diferente e numa rede diferente.

A solução é uma exclusão de regra direcionada, que o suporte pode adicionar. Não procure um interruptor para desativar a firewall; não existe para alojamento partilhado, e seria a solução errada de qualquer forma. Abra um ticket com o URL exato, a hora exata e o que estava a fazer. Consulte Abrir um Ticket de Suporte.

Bloqueio geográfico. Se restringiu o seu site a países específicos, toda a gente fica com um 403. Verifique Advanced, depois Security. Consulte Bloqueio Geográfico.

Um bloqueio de IP. Um que adicionou a si próprio em Segurança, ou um bloqueio de abuso ao nível da plataforma.

Um problema de permissão de ficheiros ou symlink. Menos comum, e geralmente surge após uma operação manual de ficheiros por SSH.

404 Não Encontrado

O servidor respondeu, mas não há nada nesse endereço.

Uma página 404s. O ficheiro ou o post genuinamente não existe, ou o URL está errado.

Todas as páginas exceto a página inicial 404s. Este é um problema de encaminhamento, e no WordPress é quase sempre permalinks. Importante: o alojamento web Kapsule executa nginx, não Apache, portanto as regras de reescrita .htaccess não fazem nada aqui. Se migrou de um anfitrião que as usava, essa é a sua causa. Consulte Problemas com Permalinks e WordPress e .htaccess.

O site inteiro 404s. Verifique se o site está apontado para o documento root correto e se o seu domínio está ligado ao site correto. Consulte Domínio Personalizado para um Website.

Funciona na sua máquina e 404s em direto. Os nomes de ficheiros Linux diferenciam maiúsculas de minúsculas. Logo.PNG e logo.png são dois ficheiros diferentes.

500 Erro Interno do Servidor

A sua aplicação executou e falhou. O servidor web está bem; o código não.

Este é o caso em que os registos lhe dão a resposta quase imediatamente, porque um erro fatal de PHP regista o ficheiro e o número de linha que falhou, o que geralmente identifica o plugin exato.

Vá para Websites, o site, Advanced, depois Logs.
Procure as entradas mais recentes.
Faça corresponder o carimbo de hora a quando viu o erro.

Consulte Registos de Erro. Para a versão específica do WordPress disto, onde a página está 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 conexão de base de dados falhando. Consulte Extensões e Configurações de PHP e Limite de Memória do WordPress.

502 Gateway Defeituoso

O servidor web tentou passar o pedido para a sua aplicação e não obteve nada útil em troca. O processo da aplicação recusou a conexão ou morreu a meio do pedido.

Causas comuns:

Um processo PHP falhou, muitas vezes por ficar sem memória num pedido.
Uma aplicação Node.js não está em execução, ou falhou no arranque.
Uma rajada 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 realmente está ativo e consulte o resultado do seu arranque. Se 502s aparecem apenas nos seus tempos mais ocupados, é um problema de capacidade e não um bug. Consulte Lentidão do Site e Limites de Recursos.

Um 502 do próprio KPanel, enquanto guarda uma configuraçã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 meio-configurado. O seu website não é afetado. Tente novamente, e se continuar a falhar, abra um ticket.

503 Serviço Indisponível

503 significa que o servidor deliberadamente não está servindo neste momento. Existem três causas específicas nesta plataforma, e a resposta diz-lhe qual.

O seu site está suspenso. Verá uma página com o cabeçalho "This site is paused". Este é um estado de faturação ou conta, não uma falha técnica, e o site volta imediatamente quando o estado desaparece. Verifique Billing. Consulte Pagamento Falhado e Conta Suspensa.

Um projeto Orbit atingiu o seu limite de gastos. A resposta carrega o cabeçalho X-Orbit-Paused: spending-cap, e a página diz que o site atingiu o seu limite de gastos mensal. Este confunde as pessoas porque nada está quebrado e nenhum ticket de suporte é necessário. O projeto deliberadamente parou de servir para que não recebesse uma fatura inesperada.

Para retomar: vá para Orbit, o projeto, Settings, depois Spending cap, e aumente o limite. O serviço é retomado assim que a alteração é aceite, o que pode demorar até uma hora. Também é retomado automaticamente no início do próximo período de faturação. Consulte Limites de Gastos do Orbit.

Manutenção da plataforma. Uma página de manutenção da plataforma inteira, que é rara e anunciada. Consulte Estado e Tempo de Atividade.

504 Gateway Tempo Limite Excedido

A sua aplicação ainda estava em funcionamento quando o servidor web perdeu a paciência. Nada falhou. Era apenas 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 chamando uma API externa lenta em cada carregamento de página.
Uma consulta de base de dados cara sem índice por trás.
Uma tarefa cron acionada por uma visualização de página em vez de cron real.

O que fazer:

Identifique qual pedido é lento. O separador APM em sites WordPress mostra-lhe. Consulte Desempenho do Site.
Para operações longas, use a linha de comando em vez do navegador. Consulte WP-CLI.
Mova o trabalho agendado para cron real. Consulte Tarefas Cron.
Aumente max_execution_time se o trabalho genuinamente precisa de mais tempo, embora isto seja uma solução alternativa e não uma correção. Consulte Extensões e Configurações de PHP.

Observe a diferença: se 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.

Sem Resposta

Por vezes não existe código de erro, porque não existe resposta. A conexão apenas pendura e eventualmente atinge o tempo limite.

Se isto acontecer de uma rede mas o site funciona de outra, e especialmente de um telemóvel em dados móveis, a causa mais provável é um bloqueio de abuso automático: uma rajada de erros ou logins falhados do seu endereço acionou uma proibição temporária ao nível da rede. Estas limpam por si, geralmente dentro de uma hora. Se precisar que seja levantada mais cedo, contacte o suporte com o endereço IP a partir do qual está a conectar.

Páginas de Erro Personalizado

Pode substituir a página de erro predefinida por 400, 401, 403, 404, 500, 502, 503 e 504 pela sua própria HTML, em Websites, o site, Advanced, depois Error pages. Kapsule fornece padrões marcados para 404, 500, 502, 503 e 504 se não tiver.

Uma coisa que vale a pena saber: uma página de erro personalizado mantém o código de estado real. Um 404 personalizado ainda devolve 404. Servir a sua página de erro com um estado 200 é uma forma clássica de destruir as suas classificações de pesquisa, e isto é deliberadamente impossível aqui. Consulte Páginas de Erro Personalizado.