Erro de memória esgotada no WordPress

O que este erro significa e como reconhecê-lo

• Um erro fatal inclui um texto semelhante a Allowed memory size of 134217728 bytes exhausted (tried to allocate ... bytes).
• O site inteiro pode falhar, ou o problema pode ficar limitado ao painel, à tela de um plugin, a uma importação, migração ou ação em lote.
• O erro pode começar após instalar ou atualizar um plugin ou tema, iniciar uma operação de dados extensa ou migrar o site para uma hospedagem com um limite de memória PHP menor.
• A página inicial pode carregar normalmente enquanto uma importação, tela de page builder, sincronização de produtos ou outra tarefa que consome muita memória falha.
• Aumentar a memória pode parecer corrigir as páginas comuns, enquanto a operação original continua falhando.

Causas principais, por probabilidade

1. O memory_limit do PHP é baixo demais para o site ou a requisição. O núcleo do WordPress, o tema ativo, os plugins, a requisição atual e os dados processados podem ultrapassar um limite padrão conservador da hospedagem.
2. Um plugin ou tema consome muita memória. Page builders, ferramentas de importação/exportação, softwares de backup, ferramentas de cache e suítes abrangentes de SEO ou marketing podem usar substancialmente mais memória durante determinadas tarefas.
3. Uma operação extensa está processando dados demais de uma só vez. Importações de mídia, sincronizações de produtos, migrações e tarefas de localizar e substituir podem ultrapassar o limite mesmo quando o carregamento normal das páginas funciona.
4. O conjunto de plugins ativos tem um alto consumo combinado de memória inicial. Vários consumidores moderados podem ultrapassar o limite quando usados em conjunto.
5. As camadas de configuração não estão alinhadas. As configurações de wp-config.php, do painel de hospedagem, do php.ini, do .user.ini e do .htaccess, quando aplicável, podem produzir valores efetivos diferentes para requisições web.
6. Um componente tem um fluxo de processamento ineficiente ou um vazamento de memória. Isso é mais provável quando uma ação específica falha com uma carga moderada ou após usos repetidos, e não apenas durante uma operação previsivelmente grande.

Como corrigir

1. Identifique a requisição que falha

Copie a mensagem completa do erro fatal, se disponível. Registre se a falha afeta todas as páginas, apenas o painel, a tela de um plugin ou uma operação específica, como uma importação ou edição em lote. Essa distinção ajuda a separar um limite geralmente baixo de um problema específico da carga de trabalho.

2. Solicite mais memória ao WordPress

Antes de editar arquivos, faça um backup ou confirme que você pode restaurar a configuração atual. Usando SFTP ou o gerenciador de arquivos da hospedagem, abra o wp-config.php e adicione esta linha acima de /* That's all, stop editing! */:

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

Isso solicita que o WordPress use 256 MB quando o servidor permitir. Se a constante já existir, edite essa definição em vez de adicionar uma segunda. Algumas tarefas administrativas podem usar uma configuração de memória administrativa separada, portanto uma falha limitada ao painel pode exigir uma investigação adicional.

3. Verifique o limite do PHP usado pelo site

O WP_MEMORY_LIMIT não pode elevar o PHP acima do próprio memory_limit do servidor. Verifique o painel de controle da hospedagem ou o php.ini usado pela versão do PHP que atende o site. Em um VPS, alterar a configuração PHP relevante pode exigir a reinicialização do PHP-FPM ou do serviço PHP aplicável; faça isso somente com o acesso e a autorização necessários.

Algumas configurações do Apache que usam mod_php permitem uma configuração como:

php_value memory_limit 256M

no .htaccess. Isso não se aplica ao PHP-FPM e pode causar um erro de configuração do servidor quando a diretiva não for permitida. Use o painel de hospedagem ou consulte o provedor antes de adicioná-la. Uma configuração do PHP em linha de comando pode ser diferente da configuração usada pelas requisições web.

4. Repita exatamente a ação que falhou

Tente novamente a importação, edição em lote, operação do plugin ou requisição de página que produziu o erro. Carregar apenas a página inicial não é suficiente, pois uma página comum pode usar muito menos memória do que a tarefa que falhou. Se a tarefa for concluída, monitore-a e evite aumentar ainda mais o limite, a menos que a mesma operação continue precisando de mais memória.

5. Reduza o uso máximo de memória da operação

Para importações, migrações, sincronizações ou edições em lote, diminua o tamanho do lote na ferramenta ou divida o trabalho em grupos menores. Isso geralmente é mais seguro do que atribuir um limite muito alto a todas as requisições PHP. Executar tarefas grandes em um período mais tranquilo pode reduzir o risco operacional, mas não diminui o requisito de memória máxima da requisição.

6. Isole o plugin ou tema provável

Se 256M ou 512M ainda não for suficiente, ou se o problema tiver começado após uma alteração, teste o componente associado à tela ou tarefa que falha. Use uma cópia de staging quando possível. Em um site em produção, faça um backup primeiro e desative os plugins um por vez. Se o painel estiver inacessível, use SFTP ou o gerenciador de arquivos para renomear temporariamente o diretório do plugin suspeito, impedindo que o WordPress o carregue.

Dê prioridade ao componente alterado recentemente e ao plugin relacionado à falha, seguidos por page builders, ferramentas de importação/exportação, ferramentas de backup, ferramentas de cache e suítes grandes e integradas. Se as páginas do front-end falharem, teste também com um tema padrão. Restaure os componentes não afetados após cada teste para saber qual configuração foi testada.

7. Compare os valores efetivos da configuração

Se alterar o WP_MEMORY_LIMIT não produzir nenhum efeito visível, compare a requisição do WordPress com o valor do PHP usado pelas requisições web. Revise o painel de hospedagem, o php.ini, o .user.ini e as configurações aplicáveis do .htaccess, além de qualquer teto imposto pelo provedor. Consulte a hospedagem para saber qual configuração PHP se aplica se você não conseguir verificá-la por conta própria.

8. Confirme a correção definitiva

Execute novamente a operação original que falhou e depois verifique páginas importantes do front-end e do painel administrativo. Se o site funcionar apenas após definir um limite muito alto, considere isso uma pista de diagnóstico e continue investigando o plugin, tema, consulta ou tamanho de lote responsável, em vez de considerar o problema resolvido permanentemente.

Prevenção e como verificar a correção

• Use um valor de memória do WordPress definido de forma planejada e compatível com a hospedagem, em vez de esperar uma tarefa de produção falhar.
• Remova plugins não utilizados e revise periodicamente o conjunto de plugins ativos, pois o uso de memória inicial é cumulativo.
• Mantenha os lotes de importação, migração, sincronização e edição em massa dentro da memória PHP disponível.
• Teste operações grandes em staging ou com um conjunto limitado de dados antes de processar o site inteiro.
• Após alterações em plugins ou configurações, repita a operação que falhou anteriormente e verifique as páginas do front-end e do painel administrativo.
• Registre qual configuração PHP se aplica às requisições web para que futuras alterações de memória sejam feitas no local correto.

Perguntas frequentes