# Códigos de Erro HTTP na KapsuleHost Source: https://support.kapsulehost.com/pt-pt/http-error-codes 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: ```sh 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 ler o estado de uma resposta nas ferramentas de programador do navegador](https://support.kapsulehost.com/help/screenshots/http-error-codes.fdd177cf.webp) ## 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](https://support.kapsulehost.com/pt-pt/site-password-protect). 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](https://support.kapsulehost.com/pt-pt/opening-a-support-ticket). **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](https://support.kapsulehost.com/pt-pt/site-geo-blocking). **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](https://support.kapsulehost.com/pt-pt/wordpress-permalink-issues) e [WordPress e .htaccess](https://support.kapsulehost.com/pt-pt/wordpress-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](https://support.kapsulehost.com/pt-pt/custom-domain-for-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. 1. Vá a **Websites**, o site, **Definições**, depois **Registos**. 2. Veja as entradas mais recentes. 3. Faça corresponder a hora ao momento em que viu o erro. Consulte [Registos de Erro](https://support.kapsulehost.com/pt-pt/error-logs). 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](https://support.kapsulehost.com/pt-pt/wordpress-white-screen). 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](https://support.kapsulehost.com/pt-pt/php-extensions-and-ini) e [Limite de Memória do WordPress](https://support.kapsulehost.com/pt-pt/wordpress-memory-limit). ## 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](https://support.kapsulehost.com/pt-pt/site-slow-resource-limits). > **Note:** 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](https://support.kapsulehost.com/pt-pt/billing-failed-payment) e [Conta Suspensa](https://support.kapsulehost.com/pt-pt/account-suspended). **Manutenção da plataforma.** Uma página de manutenção de toda a plataforma, o que é raro e anunciado previamente. Consulte [Estado e Disponibilidade](https://support.kapsulehost.com/pt-pt/status-and-uptime). ## 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: 1. Identifique qual o pedido que está lento. O separador APM em sites WordPress mostra-lhe isso. Consulte [Desempenho do Site](https://support.kapsulehost.com/pt-pt/site-performance). 2. Para operações longas, utilize a linha de comandos em vez do navegador. Consulte [WP-CLI](https://support.kapsulehost.com/pt-pt/wordpress-wp-cli). 3. Mova o trabalho agendado para um cron real. Consulte [Tarefas Cron](https://support.kapsulehost.com/pt-pt/cron-jobs). 4. Aumente `max_execution_time` se 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](https://support.kapsulehost.com/pt-pt/php-extensions-and-ini). 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](https://support.kapsulehost.com/pt-pt/site-error-pages). ## Leituras Relacionadas - [Site Não Carrega](https://support.kapsulehost.com/pt-pt/website-not-loading) - [Registos de Erro](https://support.kapsulehost.com/pt-pt/error-logs) - [Lentidão do Site e Limites de Recursos](https://support.kapsulehost.com/pt-pt/site-slow-resource-limits) - [Estado e Disponibilidade](https://support.kapsulehost.com/pt-pt/status-and-uptime) - [Websites](https://support.kapsulehost.com/pt-pt/sites-overview) - [Glossário de Alojamento](https://support.kapsulehost.com/pt-pt/glossary)