Como corrigir o produto do WooCommerce com página em branco
O que é o produto do WooCommerce com página em branco?
A página em branco do produto, também chamada de White Screen of Death, é quando o WooCommerce carrega a URL do produto mas não exibe nenhum conteúdo, deixando uma tela completamente vazia. Diferente de um erro 404, a página existe e responde, mas o PHP para de executar no meio da renderização: um erro fatal sem exibição de mensagem, um template quebrado ou falta de memória interrompem a montagem da página do produto.
Como identificar
- A página do produto abre totalmente branca, sem cabeçalho, rodapé ou conteúdo.
- Outras páginas do site funcionam, mas só os produtos individuais (‘single product’) ficam em branco.
- No log (wp-content/debug.log ou no log do servidor) aparece ‘PHP Fatal error’ ou ‘Allowed memory size exhausted’.
- Com o WP_DEBUG ativo surge a mensagem ‘There has been a critical error on this website’ no lugar da tela branca.
Como prevenir
- Mantenha o WP_DEBUG_LOG ativo em staging para capturar erros fatais antes de publicar mudanças na loja
- Atualize WooCommerce, tema e plugins de produto em ambiente de testes antes de aplicar na loja ao vivo
- Revise os templates do WooCommerce em WooCommerce > Status a cada atualização para evitar overrides desatualizados
Causa
- Erro fatal de PHP em um plugin ou no tema disparado só no template de produto (single-product.php), com display_errors desligado.
- Template single-product.php ou content-single-product.php desatualizado ou ausente em um tema com override do WooCommerce.
- Limite de memória do PHP (memory_limit) baixo demais para renderizar a página do produto com galeria, variações e plugins ativos.
- Plugin de página de produto (galeria, avaliações, multi-idioma) incompatível com a versão atual do WooCommerce ou do PHP 8.
- Shortcode ou bloco quebrado na descrição do produto interrompendo a execução do PHP no meio da página.
Como resolver
- Ative o WP_DEBUG para ver o erro real: no wp-config.php, ative o modo de depuração com log para revelar a mensagem por trás da tela branca. O log apontará o arquivo e a linha exata do erro fatal.
define( 'WP_DEBUG', true ); define( 'WP_DEBUG_LOG', true ); define( 'WP_DEBUG_DISPLAY', false ); - Leia o debug.log: abra wp-content/debug.log e procure a linha 'PHP Fatal error'. Ela diz qual plugin, tema ou arquivo está quebrando a página do produto.
- Teste com tema padrão e plugins desativados: ative um tema padrão (Storefront) e desative todos os plugins exceto o WooCommerce. Se o produto voltar a aparecer, reative um a um para encontrar o culpado.
- Aumente o limite de memória do PHP: se o log mostrar 'Allowed memory size exhausted', aumente o memory_limit no wp-config.php para 256M e recarregue a página do produto.
define( 'WP_MEMORY_LIMIT', '256M' ); - Cheque templates desatualizados: em WooCommerce > Status, role até Templates e veja se single-product ou content-single-product aparecem em vermelho. Atualize o tema ou remova o override antigo para usar o template padrão do WooCommerce.
// functions.php do tema filho — registra no log se o template de produto
// do WooCommerce esta ausente, causa comum de pagina de produto em branco
add_action( 'template_redirect', function () {
if ( function_exists( 'is_product' ) && is_product() ) {
$template = wc_locate_template( 'single-product.php' );
if ( ! file_exists( $template ) ) {
error_log( 'WooCommerce: template single-product.php nao encontrado em ' . $template );
}
}
} );Perguntas frequentes
A página do produto abre totalmente branca. Como descubro o motivo?
Só os produtos ficam em branco, o resto do site funciona. Por quê?
A tela branca pode ser falta de memória do PHP?
Como ver o erro sem exibir mensagens para os visitantes?
Atualizei o PHP para a versão 8 e os produtos ficaram em branco. O que houve?
Um template antigo do tema pode causar a página em branco?
Como corrigir o filtro de produtos do WooCommerce no JetSmartFilters
O Product Filter do WooCommerce no JetSmartFilters não filtra produtos quando o provedor escolhido em 'This filter for' ou o Query ID do widget de filtro não apontam para a mesma query que monta a grade da loja. Sem esse pareamento, o filtro envia a busca para um lugar diferente do que exibe os produtos, e a vitrine continua igual.
Como corrigir carrinho do WooCommerce que esvazia sozinho
O carrinho do WooCommerce que esvazia sozinho acontece quando os itens adicionados desaparecem antes do checkout, derrubando a conversão. A causa quase sempre é cache servindo a página do carrinho em vez de ignorá-la, ou a sessão/cookie do cliente sendo perdida entre as requisições.
Como corrigir o cálculo de frete errado no WooCommerce
O cálculo de frete errado no WooCommerce acontece quando o valor da entrega no checkout vem maior, menor ou diferente do esperado, ou simplesmente não aparece. Quase sempre vem de zonas de entrega mal configuradas, de produtos sem peso e dimensões, ou de classes de frete e regras de frete grátis conflitando entre si.
Como corrigir a página de produto do WooCommerce que quebra com o Astra Pro
A product page do WooCommerce com Astra quebrar significa que a tela do produto abre com layout desalinhado, galeria empilhada ou botão de comprar fora do lugar. Quase sempre vem de template do WooCommerce desatualizado no tema filho, do módulo WooCommerce do Astra Addon desativado ou de um page builder assumindo a single product.
Como corrigir o erro de checkout do WooCommerce causado pelo cache do WP Rocket
O checkout do WooCommerce com WP Rocket não funciona quando a página de finalizar compra é servida em cache ou tem o JavaScript do gateway adiado: o botão de finalizar pedido não responde, a página recarrega sem avançar ou retorna nonce expirado. A correção é garantir a exclusão de cache do checkout e liberar os scripts essenciais.
Como corrigir webhook do WooCommerce que não dispara
O webhook do WooCommerce não dispara quando um evento da loja, como um novo pedido, deveria notificar um sistema externo, mas a chamada nunca sai ou nunca chega. Quase sempre vem do webhook ficar com status Desativado após falhas, da URL de destino inacessível ou com SSL inválido, ou do WP-Cron travado.
