O que é

Erros de PHP tipicamente aparecem como 502 Bad Gateway (o nginx não consegue falar com o
PHP-FPM) ou como uma tela branca. A causa costuma ser um pool de PHP travado ou um plugin com
defeito.

O erro 502

Um 502 significa que o PHP-FPM do site não respondeu ao nginx. Causas comuns:

  • Pool travado — um processo PHP que não retorna, muitas vezes por um plugin com defeito ou
    banco corrompido.
  • Memória esgotada — o site (ou o servidor) ficou sem RAM.
  • Versão de PHP incompatível com algum plugin.

Como diagnosticar

  1. Ative a auto-recuperação do PHP-FPM — ela detecta e recupera o
    pool travado, e te avisa quando age.
  2. Olhe o log de erro na aba Logs do site.
  3. Ligue o WP_DEBUG editando o wp-config.php pelo
    gerenciador de arquivos (falsetrue) para ver o erro do
    PHP. Reverta depois.
  4. Teste trocar a versão do PHP na aba PHP (um plugin pode não suportar a versão
    atual).

Recuperação

  • A auto-recuperação reinicia o pool travado sozinha, sem derrubar os outros sites (cada site
    tem pool isolado).
  • Se precisar, reinicie os serviços em Servidor — mas o painel evita
    reiniciar o PHP-FPM compartilhado em operações comuns, justamente para não afetar todos os sites.

Como cada site roda em pool isolado, um PHP travado num site não derruba os vizinhos. Ver
Como o GW Server protege.

Veja também