Tela branca no WordPress: como achar a causa e resolver

Entenda a tela branca no WordPress e siga seis passos na VPS: log de depuração, logs do servidor, plugins, tema, limite de memória, banco de dados e permissões.

Por Redação Eleven Host · @robson.direitodigital · 28 de outubro de 2026 · 8 min de leitura

A tela branca no WordPress é um erro do PHP ou do banco de dados que não aparece na página. Para achar a causa, ligue o log de depuração, leia os logs do servidor e teste plugins e tema renomeando as pastas.

Este guia é para quem tem um site WordPress numa VPS com Nginx e PHP-FPM e abriu a página para encontrar só o fundo branco. Os passos seguem a ordem do diagnóstico: primeiro enxergar o erro, depois testar plugins, tema, memória, banco e permissões. O número 8.3 (versão do PHP) é um exemplo. Troque pelo da sua versão.

O que é a tela branca no WordPress

A documentação do WordPress chama o problema de "White Screen of Death", ou tela branca da morte. Segundo ela, tanto erros do PHP quanto erros do banco de dados podem aparecer como uma tela branca, uma tela em branco sem nenhuma informação.

Isso quer dizer que a página em branco não é a causa. Ela é o sintoma de um erro do PHP ou do banco que não mostra nenhuma informação na tela. Os passos abaixo servem para ver o erro e achar a causa.

Desde o WordPress 5.2 existe o modo de recuperação. Quando um plugin ou tema dá erro fatal, em vez da tela branca o visitante pode ver "O site está passando por dificuldades técnicas" (em inglês, "The site is experiencing technical difficulties."). O administrador recebe instruções no e-mail de administração do site. Se você viu essa mensagem, confira esse e-mail.

Se em vez da tela branca apareceu um aviso de manutenção, o motivo é outro: uma atualização interrompida pode deixar o site em modo de manutenção.

Antes de mexer: faça backup

A documentação do WordPress pede backup ou um ambiente de teste antes de alterar o site. Copie os arquivos que você vai editar, como o wp-config.php, e exporte o banco de dados. O guia Backup MySQL com mysqldump: como fazer e restaurar mostra o passo a passo do banco.

Com o backup guardado, os testes abaixo podem ser desfeitos se algo der errado.

Passo 1: ligar o log de depuração e ver o erro

O WordPress consegue gravar os erros num arquivo. No wp-config.php, adicione as linhas abaixo antes da linha /* That's all, stop editing! Happy blogging. */:

define( 'WP_DEBUG', true );

define( 'WP_DEBUG_LOG', true );

define( 'WP_DEBUG_DISPLAY', false );

@ini_set( 'display_errors', 0 );

Com isso, os erros vão para o arquivo wp-content/debug.log. O WP_DEBUG_LOG só funciona com o WP_DEBUG ligado. Já o WP_DEBUG_DISPLAY em false esconde os erros da página, para o visitante não vê-los. Repare que true e false vão sem aspas: segundo a documentação, com aspas o 'false' vira texto e conta como verdadeiro.

Abra a página com a tela branca uma vez e leia o fim do arquivo, dentro da pasta do site:

tail -n 30 wp-content/debug.log

A mensagem pode trazer o caminho de um arquivo e o número da linha. O nome da pasta no caminho mostra de onde veio o erro: wp-content/plugins aponta para um plugin e wp-content/themes aponta para o tema.

A documentação não recomenda deixar a depuração ligada em um site no ar. Quando achar o erro, volte para:

define( 'WP_DEBUG', false );

Apague também o debug.log. É um cuidado a mais, porque o arquivo pode ficar acessível.

Passo 2: ler os logs do Nginx e do PHP-FPM

Se o debug.log não foi criado ou ficou vazio, leia os logs do servidor. O primeiro é o de erros do Nginx:

sudo tail -n 50 /var/log/nginx/error.log

O segundo é o do PHP-FPM, que roda como serviço do systemd. A opção -u escolhe a unidade e a opção --since limita o período. Troque 8.3 pela versão do PHP que você usa:

sudo journalctl -u php8.3-fpm --since "1 hour ago"

Procure as linhas com a data e a hora em que você abriu a página. Uma mensagem que cita um arquivo e um número de linha mostra onde o PHP parou. Anote essa informação, porque ela decide qual dos próximos passos seguir.

Quer um servidor para hospedar o seu WordPress? Os planos de VPS saem a partir de R$ 17,00/mês, no Plano Bronze; confira na loja o que cada plano inclui. Ver planos de VPS

Passo 3: testar os plugins

Se o log aponta para um plugin, ou se ele não ajudou, teste os plugins. Com acesso ao painel, a documentação manda desativar todos e reativar um por um. Sem acesso ao painel, renomeie a pasta de plugins. A documentação diz que isso desativa todos. Dentro da pasta do site, rode:

mv wp-content/plugins wp-content/plugins_old

Abra o site. Se a página voltou, o defeito está em algum plugin. Renomeie a pasta de volta:

mv wp-content/plugins_old wp-content/plugins

Depois, entre no painel e reative os plugins um por um, abrindo o site a cada reativação. Quando a tela branca reaparecer, você achou o plugin com defeito. Deixe-o desativado e procure uma versão atualizada ou outro plugin para a mesma função.

Passo 4: testar o tema

A documentação indica que o tema é uma causa mais provável quando a tela branca apareceu logo depois de ativar um tema novo. Pelo painel, ative um tema padrão do WordPress; a documentação cita o Twenty Twenty-One como exemplo.

Sem acesso ao painel, renomeie a pasta do tema ativo dentro de wp-content/themes/. Troque meu-tema pelo nome da pasta do seu tema:

mv wp-content/themes/meu-tema wp-content/themes/meu-tema_old

Se o site voltar com um tema padrão, o defeito está no tema que você tirou. Quando terminar o teste, renomeie a pasta de volta, se for reativar o tema, ou mantenha o tema padrão até corrigir o outro.

Passo 5: limite de memória do PHP

O log pode mostrar a mensagem "Allowed Memory Size Exhausted". Segundo a documentação do WordPress, ela significa que a instalação não tem memória suficiente para o que você quer fazer.

A documentação traz duas soluções. A primeira é aumentar o limite no wp-config.php, e o exemplo dela é este:

define( 'WP_MEMORY_LIMIT', '64M' );

A segunda é ajustar o limite no php.ini. A documentação avisa que esse arquivo não vem com o WordPress, então ele pertence à configuração do PHP no servidor. Depois de mudar o php.ini, reinicie o PHP-FPM:

sudo systemctl restart php8.3-fpm

A própria documentação alerta que aumentar o limite pode esconder a causa. Se o erro de memória sumir depois do aumento, descubra o que consome tanta memória, como um plugin pesado, em vez de apenas deixar o limite maior.

Passo 6: banco de dados e permissões

Como a documentação lembra, a tela branca também pode vir de um erro do banco de dados. Se o log falar em conexão com o banco, siga o guia Erro ao estabelecer conexão com o banco de dados: solução.

Um arquivo que o PHP não consegue ler também pode causar o problema. As regras de permissão de pastas e arquivos estão no guia Erro 403 Forbidden: o que é e como resolver no seu site. Se você mexeu na configuração do Nginx, teste a sintaxe antes de aplicar:

sudo nginx -t

Se o teste apontar erro, corrija a linha indicada e recarregue:

sudo systemctl reload nginx

Vai colocar um site novo no ar? Pesquise e registre o domínio dele na Eleven Host. Registrar domínio

Perguntas frequentes

O que causa a tela branca no WordPress?

Segundo a documentação do WordPress, tanto erros do PHP quanto erros do banco de dados podem aparecer como uma tela branca, sem nenhuma informação. Plugins, temas e falta de memória estão entre os suspeitos testados neste guia.

Como ver o erro que a tela branca esconde?

Ligue o WP_DEBUG e o WP_DEBUG_LOG no wp-config.php e leia o arquivo wp-content/debug.log. Se ele não ajudar, leia os logs do Nginx e do PHP-FPM.

Posso deixar o WP_DEBUG ligado no site?

Não é o indicado. A documentação do WordPress não recomenda deixar a depuração ligada em um site no ar. Volte o WP_DEBUG para false depois de achar o erro e apague o debug.log.

Como desativar os plugins sem entrar no painel?

Renomeie a pasta wp-content/plugins para plugins_old. A documentação diz que isso desativa todos os plugins. Depois renomeie de volta e reative um por um.