Como corrigir o erro 502 Bad Gateway no Nginx

Editor iCloud25/09/2016Última Atualização 30/06/2025

0 3.870

Descubra como corrigir o erro 502 Bad Gateway no Nginx com este guia completo. Aprenda a identificar a causa do problema e as etapas necessárias para restaurar a funcionalidade do seu site.

A resposta do servidor nem sempre é 200 e as avezes nos deparamos com erros 500, 502, 404. Então vamos aprender como o corrigir o erro 502 Bad Gateway no Nginx. Se você executa um Nginx no seu servidor web, provavelmente pode já ter encontrado os irritantes 502 erros de bad gateway.

Este é erro muito comum e é gerado mais provavelmente pelo PHP. Ou então, pelas configurações de buffer e tempos limite FastCGI. Este tutorial mostra como corrigir Nginx 502 gateway inválido no servidor web Nginx.

Você vai aprender como corrigir o erro 502, o problema e a opção de configuração para evitar que ele ocorra novamente na reinicialização.

Para corrigir o erro 502 Bad Gateway no Nginx

Este artigo pressupõe que você tenha pelo menos conhecimentos básicos de Linux e saiba como usar o shell. E o mais importante, você hospeda seu site em um VPS. O ajuste é bastante simples. Vou mostrar-lhe através do passo a passo resolver erro 502 bad gateway no Nginx com três métodos.

Método 1. Mudanças na configuração Nginx

#nano /etc/nginx/nginx.conf http { ... fastcgi_buffers 8 16k; fastcgi_buffer_size 32k; ... }

Método 2. mudança PHP-FPM para escutar em um socket unix ou socket TCP.

#nano /etc/php-fpm.d/www.conf listen = /var/run/php5-fpm.sock To: listen = 127.0.0.1:9000

Se você estiver configurando php-fpm para escutar em um socket Unix, você também deve verificar se o arquivo de soquete tem o proprietário e as permissões corretas para corrigir o erro 502.

chmod 0660 /var/run/php5-fpm.sock chown www-data:www-data /var/run/php5-fpm.sock

Método 3. Desabilitar APC

APC cache pode causar problemas 502 Bad Gateway de menores de ambientes particulares que causam falhas de segmentação. Eu sugiro usar Memcache (d), mas XCache também é uma boa alternativa.

Se você estiver usando o Wordpress confira o registro de erros

Se o erro 502 Bad Gateway apareceu depois de alguma mudança ou atualização. É possível que a culpa seja do próprio site. A melhor abordagem, neste caso, é checar o registro de erro para ver sugestões do que pode ser feito.

No WordPress, você pode ativar o registro de error adicionado as seguintes linhas ao wp-config.php para corrigir o erro 502:

define( 'WP_DEBUG', true ); 
define( 'WP_DEBUG_LOG', true ); 
define( 'WP_DEBUG_DISPLAY', false );

Todas as entradas geradas vão aparecer no arquivo wp-contents/debug.log.

Como o erro 502 Bad Gateway aparece

O 502 Bad Gateway pode ser personalizado por cada site. Embora seja bastante incomum, diferentes servidores da web descrevem esse erro de maneira diferente . Abaixo estão algumas maneiras comuns que você pode ver:

502 Bad Gateway
502 Serviço Sobrecarregado Temporariamente
Erro 502
Erro Temporário (502)
502 Erro Proxy502 Erro do servidor: o servidor encontrou um erro temporário e não pôde concluir sua solicitação
HTTP 502
502. Isso é um erro
Bad Gateway: O servidor proxy recebeu uma resposta inválida de um servidor upstream
Erro HTTP 502 - gateway inválido

Causa de erro 502 bad gateway

O erro 502 Bad Gateway ocorre quando um servidor age como um proxy ou gateway e não consegue obter uma resposta válida de um servidor upstream (servidor de origem). Existem várias razões que podem levar a esse erro. Aqui estão algumas das causas mais comuns:

1. Servidor Upstream Fora do Ar

Se o servidor de origem (upstream), como um servidor de aplicação ou um banco de dados, estiver inativo ou não puder ser acessado, o Nginx não conseguirá se comunicar com ele, resultando em um erro 502.

2. Problemas de Configuração

Configurações erradas no arquivo de configuração do Nginx podem causar o erro. Isso pode incluir:

Endereços IP ou portas incorretos: O Nginx pode estar tentando se conectar ao endereço errado.
Configuração de socket: Se você estiver usando Unix sockets, um caminho incorreto pode resultar em falha na conexão.

3. Timeouts Excedidos

Se o servidor upstream demorar muito para responder, o Nginx pode atingir seus limites de tempo (timeout) e retornar um erro 502. Isso pode ocorrer em aplicações que têm desempenho lento ou que estão sobrecarregadas.

4. Problemas de Rede

Problemas de conectividade de rede entre o Nginx e o servidor upstream, como firewalls configurados de forma inadequada ou problemas de roteamento, podem impedir a comunicação necessária.

5. Sobrecarga do Servidor

Se o servidor upstream estiver sob alta carga e não conseguir lidar com todas as solicitações, ele pode não responder a tempo, resultando em um erro 502. Isso é comum em servidores que não têm recursos suficientes.

6. Erros em Aplicações Web

Se houver bugs ou código mal escrito na aplicação que o servidor upstream executa, isso pode causar falhas que impedem o processamento adequado das solicitações.

7. Falhas em Middleware

Se você estiver usando middleware, como proxy reverso ou balanceadores de carga, que não estão configurados corretamente, isso pode causar erros 502. Um problema em qualquer serviço de middleware pode interromper a comunicação entre o Nginx e o servidor upstream.

8. Problemas com Servidores de Banco de Dados

Se o servidor de banco de dados (como MySQL, PostgreSQL, etc.) estiver fora do ar ou apresentando lentidão significativa, isso pode afetar a capacidade do servidor de aplicação de responder a solicitações, resultando em um erro 502.

9. Limites de Recursos do Sistema

Se os limites de memória ou de número de processos forem atingidos, o servidor upstream pode falhar em processar novas solicitações, levando a um erro 502.

Como Corrigir o Erro 502 Bad Gateway no Nginx com Acesso ROOT?

Como você já sabe, o erro 502 Bad Gateway no Nginx é um dos problemas de servidor mais comuns enfrentados por administradores de sistemas e desenvolvedores. Esse erro ocorre quando o Nginx, atuando como um proxy reverso, não consegue se comunicar com o servidor de origem (upstream). Então vamos lá!

1. Verifique os Servidores Upstream

O primeiro passo na resolução do erro 502 Bad Gateway é verificar se o servidor upstream está em execução. Execute o seguinte comando para verificar o status do serviço:

bash systemctl status nome-do-serviço

Substitua nome-do-serviço pelo serviço que o Nginx está tentando acessar, como php-fpm ou gunicorn.

2. Verifique os Logs do Nginx

Os logs do Nginx podem fornecer informações valiosas sobre a causa do erro. Para acessar os logs de erro, use o seguinte comando:

bash tail -f /var/log/nginx/error.log

Verifique se há mensagens de erro que podem indicar o que está causando a falha de comunicação.

3. Aumente os Limites de Timeout

Os limites de timeout no Nginx podem estar causando o erro se o servidor upstream demorar muito para responder. Para aumentar os limites, edite o arquivo de configuração do Nginx (/etc/nginx/nginx.conf ou outro arquivo de configuração específica do site):

nginx http {
    ...
    proxy_read_timeout 300;  # Aumenta o tempo de leitura
    proxy_connect_timeout 300;  # Aumenta o tempo de conexão
    ...
}

Depois de fazer essas alterações, reinicie o Nginx:

bash sudo systemctl restart nginx

4. Verifique a Configuração do Firewall

Certifique-se de que não há restrições de firewall que impeçam o Nginx de se comunicar com o servidor upstream. Use o seguinte comando para listar as regras do firewall:

bash sudo ufw status

Se necessário, adicione as regras apropriadas para permitir o tráfego entre o Nginx e o servidor de origem.

5. Verifique a Configuração do Servidor Upstream

Verifique se a configuração do Nginx está correta e se o servidor upstream está configurado corretamente. Um exemplo de configuração do Nginx para conectar-se ao PHP-FPM pode ser assim:

nginx location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # Verifique se o socket está correto
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
}

6. Reinicie os Serviços

Após fazer alterações na configuração do Nginx ou no servidor upstream, sempre reinicie os serviços para garantir que as mudanças tenham efeito:

bash sudo systemctl restart nginx
sudo systemctl restart nome-do-serviço

Resumo para erros no servidor

Como faço para corrigir o 502 Bad Gateway nginx?

Corrigindo um erro 502 de gateway inválido Recarregue a página.

Procure por problemas de conectividade do servidor.
Verifique se há alterações de DNS.
Peneire seus registros. Corrija configurações de firewall defeituosas.
Vasculhe o código do seu site para encontrar bugs.
Entre em contato com seu host.

O que é um erro 502 Bad Gateway?

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.

O que causa um erro de gateway inválido?”]

Erros de rede: problemas de DNS, problemas de roteamento e problemas relacionados ao ISP também podem levar a um erro 502 na porta de entrada.
Tempo limite do software do servidor: esse erro também pode ocorrer quando um servidor da web leva mais tempo para ser concluído e uma ferramenta de cache atinge seus valores de tempo limite naquele tempo.
Consultas lentas também podem causar esse problema.

Se o seu provedor estiver causando o erro 502, contrate outro servidor de hospedagem. Este VPS é o melhor e mais barato!

Conclusão

O erro 502 Bad Gateway no Nginx pode ser frustrante, mas seguindo as etapas acima, você pode identificar e corrigir rapidamente a causa do problema. Uma boa prática é monitorar regularmente os logs do Nginx e a saúde dos serviços upstream para evitar que esse erro ocorra no futuro. Se o problema persistir após seguir todos os passos, considere consultar a documentação do Nginx ou buscar suporte em fóruns especializados.

Perguntas Frequentes

1. O que significa 502 Bad Gateway?

O erro 502 Bad Gateway indica que o servidor Nginx recebeu uma resposta inválida do servidor upstream ao tentar processar a solicitação.

2. Como posso saber se o servidor upstream está fora do ar?

Verifique o status do serviço usando systemctl ou acesse diretamente o servidor upstream através do navegador ou através de outras ferramentas, como curl, para ver se ele está respondendo.

3. O que fazer se não consigo encontrar a causa do erro?

Se as soluções acima não resolverem o problema, considere aumentar o nível de log do Nginx para obter mais detalhes ou verificar se há problemas de rede que estão afetando a comunicação entre o Nginx e o servidor upstream.