Como corrigir o erro 502 Bad Gateway no WordPress

Um dos aspectos mais frustrantes de administrar um site é ter que solucionar um erro quando você não sabe por que ele está acontecendo. Alguns problemas, como o erro de gateway incorreto 502, têm muitas causas potenciais. Isso significa que você pode precisar tentar várias soluções antes de encontrar a solução certa. Nesta postagem, mostraremos como navegar nesse erro complicado e resolvê-lo.

Vamos ao trabalho!

Inscreva-se no nosso canal no Youtube

O que é o erro 502 Bad Gateway (e por que ele acontece)

O erro 502 de gateway inválido aparece de vez em quando e geralmente significa que há um problema com o servidor.

Quando você visita um site, seu navegador envia uma ou mais solicitações ao servidor que hospeda o site. Se tudo estiver funcionando corretamente, esse servidor enviará de volta as informações solicitadas pelo seu navegador e o site será carregado. Por outro lado, o erro 502 de gateway inválido ocorre quando um servidor envia de volta uma resposta 'inválida'. Isso pode significar que o tempo limite da conexão expirou ou pode ser o resultado de vários outros problemas.

Da Mozilla Developer Network, a definição oficial é:

O código de resposta de erro do servidor HyperText Transfer Protocol (HTTP) 502 Bad Gateway indica que o servidor, enquanto agia como um gateway ou proxy, recebeu uma resposta inválida do servidor upstream.

Até agora, isso pode parecer simples. No entanto, a conexão entre o seu navegador e a maioria dos sites não é tão direta como costumava ser. Por exemplo, a solicitação do seu navegador pode ser roteada por meio de um servidor proxy antes de chegar ao host em questão, portanto, pode ser difícil identificar onde o problema está localizado. Muitos sites também usam vários servidores, o que complica ainda mais as coisas, pois qualquer um deles pode ser a causa do erro 502.

Tudo isso significa que existem algumas causas potenciais para esse código de erro específico. Pode ser o resultado de:

• Erros em seu banco de dados.
• Um servidor que atingiu o tempo limite, não está disponível no momento ou simplesmente não está funcionando como planejado.
• O servidor está sobrecarregado com muitas solicitações. Talvez um ataque DDOS, ou mesmo apenas um pico maior do que o pretendido no tráfego.
• Um problema com seu servidor proxy reverso.
• Scripts PHP defeituosos, cortesia de um de seus plug-ins ou temas.

A boa notícia é que, se o problema for do lado do servidor, talvez você não precise fazer nada. Nesses casos, o seu provedor de hospedagem geralmente vai socorrer o salvamento rapidamente (já que os clientes tendem a não apreciar o tempo de inatividade). Você deve entrar em contato com a equipe de suporte do host o mais rápido possível após receber o aviso de que seu site foi afetado por um erro 502.

Com isso em mente, vamos nos concentrar no que fazer se o erro de gateway inválido 502 não desaparecer por conta própria rapidamente. Afinal de contas, a maioria dos sites não pode ficar fora do ar por horas, então, se esse erro persistir, é hora de começar a solucionar o problema do seu lado.

Como corrigir o erro 502 de gateway inválido

Antes de mudar para o modo de solução de problemas, há um teste rápido que você pode executar para determinar se o servidor está respondendo como deveria. Você pode tentar executar um traceroute, para ver se o seu servidor está acessível em primeiro lugar. Se for, então o problema provavelmente está no seu lado. Caso contrário, é recomendável entrar em contato com seu provedor de hospedagem.

Você também deve tentar redefinir o roteador e verificar as configurações do Sistema de Nome de Domínio (DNS). Essas são correções básicas que às vezes podem fazer o erro 502 desaparecer e são fáceis de resolver sozinho. Se você achar que nenhuma das soluções resolve o problema, no entanto, você pode usar os seguintes métodos para solucionar o erro 502.

Limpe o cache do seu navegador

O erro 502 pode aparecer quando você tenta acessar seu site, mesmo que o problema subjacente tenha sido resolvido. Isso ocorre se o seu navegador estiver contando com o cache, em vez de carregar a versão mais recente do seu site a partir do servidor.

Basta recarregar o site algumas vezes para resolver o problema. Especialmente se você estiver usando a recarga forçada via Shift-CTRL-R no Windows ou Shift-CMD-R no Mac.

Se tudo isso falhar, você deverá esvaziar o cache do navegador manualmente. Os usuários do Chrome podem fazer isso navegando até o menu Configurações> Avançado e localizando a opção Limpar dados de navegação :

Procure a opção Imagens e arquivos em cache na guia Básico e clique em Limpar dados após selecioná-lo. Lembre-se de que este menu também excluirá seu histórico de navegação, se você não desabilitar essa configuração antes de clicar no botão Limpar dados .

Esse mesmo processo também pode ser concluído usando Firefox, Safari, Internet Explorer e praticamente qualquer outro navegador. Depois de limpar o cache, tente recarregar seu site mais uma vez. Se o erro persistir, é hora de levar a sério. Para obter mais informações sobre como limpar o cache, você pode encontrá-lo na página de hub do Hubspot no tópico.

Desative temporariamente sua rede de distribuição de conteúdo (CDN)

Anteriormente, mencionamos que as solicitações do seu navegador às vezes serão roteadas por meio de um servidor proxy reverso. Em outras palavras, o uso de um servidor proxy coloca um intermediário entre o navegador do usuário e o servidor do site.

Alguns serviços, como Content Delivery Networks (CDN), contam com a tecnologia de proxy reverso para rotear o tráfego de entrada da forma mais eficiente possível. No entanto, às vezes, essa camada extra pode criar problemas quando você tenta se conectar ao servidor de origem de um site. Quando isso acontece, seus visitantes (e você) podem se deparar com o temido erro 502 de gateway inválido.

Felizmente, é fácil verificar se o seu CDN está causando esse problema. Tudo que você precisa fazer é desativar temporariamente o serviço e, em seguida, testar se o seu site carrega corretamente sem ele. O processo de desabilitar seu CDN varia de acordo com o serviço que você está usando, mas geralmente é simples.

Por exemplo, os usuários do Cloudflare só precisam navegar até a guia Visão geral em seu painel. Dentro, você encontrará uma lista de propriedades que estão executando o serviço. Em seguida, você precisará procurar o grande botão Pausar na seção Pausar site e clicar nele:

Agora, ao tentar acessar seu site, o servidor de origem responderá à solicitação sem nenhum intermediário atrapalhar. Se o erro 502 desaparecer, o seu CDN provavelmente é a origem do problema. Na maioria dos casos, você só precisa esperar algumas horas antes de reativar o serviço. Claro, certifique-se de verificar e certificar-se de que o erro ainda tenha desaparecido depois.

Se estiver usando outro CDN, você precisará consultar sua documentação para obter instruções sobre como desativar temporariamente o serviço. No entanto, se o seu CDN não for o problema, há mais uma correção que você pode tentar.

Teste temas e plug-ins do WordPress

Até agora, falamos sobre três causas potenciais por trás do erro 502: seu servidor, seu navegador e serviços intermediários, como CDNs. Isso deixa apenas uma opção se você tiver certeza de que o problema é do seu lado, e esse é o seu site. Se você estiver executando o WordPress especificamente, um de seus plug-ins ou temas pode estar tentando executar um script que seu servidor não pode carregar corretamente. Isso pode resultar em uma resposta inválida quando seu navegador enviar uma solicitação, acionando o erro 502.

Você só pode ter um tema ativo por vez, então pode simplesmente desativar o atual e mudar para um tema WordPress padrão temporariamente, para ver se isso resolve o erro. Por outro lado, descobrir se um plugin está causando problemas pode levar mais tempo, dependendo de quantos deles estão ativos no momento.

Uma vez que você não tem acesso ao seu painel no momento devido ao erro, você precisará desativar seus plug-ins e temas manualmente. Lembre-se de que esse processo não envolve a exclusão de plug-ins e temas, e sua reativação leva apenas alguns instantes. Portanto, a funcionalidade do seu site não deve ser afetada. Mesmo assim, você deve ter um backup recente pronto para o caso.

Em seguida, abra o cliente FTP de sua escolha. Somos grandes fãs do FileZilla, então vamos usá-lo como nosso exemplo. Faça login em seu site via FTP e navegue até a pasta public_html - wp-content - plugins . Deve haver uma pasta para cada um de seus plug-ins instalados dentro - mesmo aqueles que não estão ativos:

Se você clicar com o botão direito em qualquer uma dessas pastas, verá várias opções, incluindo uma chamada Renomear . Clique nele agora e altere o nome da pasta para algo como disabled.pluginname :

Quando você acessar seu site agora, o WordPress não conseguirá encontrar esse plugin, então ele será carregado sem ele. Se o plugin que você acabou de desativar estava causando o erro 502, seu site deve carregar corretamente. Só para ter certeza, lembre-se de usar o comando CTRL + F5 (ou o equivalente do OS X) para forçar seu navegador a deletar o cache antes de recarregar o site.

Para evitar confusão, você deve solucionar o problema de um plug-in de cada vez. Altere o nome de uma pasta, tente recarregar seu site e veja se ele ainda está exibindo o erro 502. Se for, restaure o nome original da pasta. Repita esse processo com cada pasta até encontrar uma que esteja causando o erro ou até testar todos os plug-ins. Você pode usar o mesmo processo para testar seu tema ativo, o que forçará o WordPress a usar um de seus temas padrão.

Se um de seus plug-ins ou temas estiver causando o erro 502, você pode excluí-lo completamente e procurar por um substituto. Se estiver desatualizado, você também pode tentar atualizá-lo para ver se isso resolve o problema. Em alguns casos, o script do problema será corrigido rapidamente, portanto, você pode sempre retomar o uso desse plugin ou tema mais tarde.

Outras correções rápidas (potenciais)

Agora, essas correções acima provavelmente irão encontrar e consertar o culpado se o erro 502 estiver sendo causado por algo do seu lado e não do servidor. Se não desaparecer, lembre-se de que sugerimos que você entre em contato com seu host da web para permitir que eles classifiquem o servidor e diagnosticem quaisquer problemas lá.

Dito isso, você pode ajudar a acelerar o processo realizando algumas verificações rápidas.

A primeira dessas verificações é qualquer registro que seu site possa ter salvo. Se for WordPress, existem várias maneiras de ver. Temos um artigo sólido sobre o uso desses logs para melhorar o seu site que pode ser de alguma ajuda aqui. Os sites WP que executam as versões 5.0 ou superiores estão equipados com uma ferramenta de integridade do site que você pode verificar dentro do painel do administrador, portanto, certifique-se de ver o que ele tem a dizer.

Você também pode verificar se os cookies do seu navegador estão limpos. Eles são totalmente separados do cache e nem sempre queremos limpá-los. Se você mantiver qualquer informação salva em seu navegador, isso irá apagá-la. Mas esses mesmos cookies também podem 502 a conexão entre você e esses sites, então pode ser um Catch-22. De qualquer forma, é muito fácil limpar os cookies em qualquer navegador importante.

Se o seu site simplesmente travar, pode ser que haja algo em segundo plano que precise de mais tempo para ser executado. Você pode aumentar o tempo de execução permitido por um site WordPress simplesmente editando seu arquivo functions.php . Se você não estiver no WP, também pode fazer isso via .htaccess ou php.ini . Thimpress tem um guia muito bom sobre como fazer tudo isso.

Finalmente, você pode verificar se há erros de DNS. Com isso, queremos dizer que você moveu hosts ou mudou para um tipo diferente de plano ou servidor. Você pode ter ajustado os servidores de nomes ou qualquer outra coisa que poderia dar errado. As configurações de DNS são muito específicas e sujeitas a erros de configuração. Então, vá para seu cPanel ou painel, certifique-se de que tudo esteja alinhado entre seu host e seu registrador de domínio e as configurações em seu próprio site. Às vezes, um fio é cruzado ou um único erro de digitação interrompe tudo em seu caminho. Um pouco de revisão de DNS pode ajudar muito aqui.

E se você estiver realmente interessado em ter certeza de que o DNS está OK do seu lado, você pode iniciar o terminal e limpar o cache DNS manualmente.

Conclusão

Resolver erros do WordPress é geralmente mais fácil do que você imagina. Mesmo os problemas que têm muitas causas potenciais, como o erro de gateway incorreto 502, são bem compreendidos e documentados. Você pode ter que experimentar várias soluções antes de chegar a uma que funcione, mas o processo de solução de problemas não deve demorar muito se você seguir as instruções corretas.

Se você se deparar com o erro 502 de gateway incorreto em seu site e ele não desaparecer após alguns minutos (ou após uma chamada rápida para a equipe de suporte do host), é provável que o problema esteja no seu lado. Basta seguir os processos e truques que mencionamos acima e você e seus usuários deverão voltar ao seu site em um piscar de olhos.

Você já se deparou com o erro 502 de gateway inválido em um de seus sites? Compartilhe suas experiências conosco na seção de comentários abaixo!

Imagem em miniatura do artigo por windwheel / shutterstock.com.