Produto WooCommerce em branco: como corrigir a página

Tipo WooCommerce

Nome do erro Produto do WooCommerce com página em branco EN: WooCommerce blank product page

Severidade Grave

Descrição O produto do WooCommerce com página em branco acontece quando a página de um produto abre totalmente vazia, sem texto, imagem ou botão de comprar. A causa quase sempre é um erro fatal de PHP silenciado, um template de produto ausente no tema, ou o limite de memória do PHP estourado ao renderizar a página.

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.

Antes de começar: Faça backup do site antes de editar o wp-config.php ou remover overrides de template. Mantenha o WP_DEBUG_DISPLAY desligado em produção: exibir erros de PHP em público revela caminhos do servidor a possíveis atacantes.

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.

PHP

// 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?

Ative o WP_DEBUG com WP_DEBUG_LOG no wp-config.php e recarregue o produto. O arquivo wp-content/debug.log vai registrar a linha 'PHP Fatal error' apontando o plugin, tema ou arquivo que está interrompendo a renderização.

Só os produtos ficam em branco, o resto do site funciona. Por quê?

Isso indica um problema específico do template de produto: single-product.php ausente ou quebrado, um plugin que só atua na página de produto, ou um shortcode quebrado na descrição. Teste com tema padrão para confirmar se o culpado é o tema.

A tela branca pode ser falta de memória do PHP?

Sim. Se o log mostra 'Allowed memory size exhausted', o PHP fica sem memória ao montar a página com galeria, variações e plugins. Aumente o WP_MEMORY_LIMIT para 256M no wp-config.php e teste de novo.

Como ver o erro sem exibir mensagens para os visitantes?

Use WP_DEBUG_LOG como verdadeiro e WP_DEBUG_DISPLAY como falso. Assim o erro é gravado no debug.log para você ler, mas os clientes continuam vendo a página normal em vez de uma mensagem técnica de PHP.

Atualizei o PHP para a versão 8 e os produtos ficaram em branco. O que houve?

Algum plugin de produto provavelmente é incompatível com o PHP 8 e dispara um erro fatal. Leia o debug.log para identificar o plugin, atualize-o ou substitua-o, e teste a página do produto novamente.

Um template antigo do tema pode causar a página em branco?

Sim. Se o tema tem uma cópia desatualizada de single-product.php, ela pode chamar funções que não existem mais e quebrar a página. Verifique templates desatualizados em WooCommerce > Status e atualize o tema ou remova o override.

Grave

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.

Grave

Como corrigir email de pedido do WooCommerce não enviado

Quando o WooCommerce não envia o email de pedido, o cliente não recebe a confirmação e a loja não é avisada da venda. A causa quase sempre é a função mail() do PHP sendo bloqueada pela hospedagem ou marcada como spam; configurar um SMTP autenticado resolve a maioria dos casos.

Grave

Como corrigir o estoque do WooCommerce mostrando errado

O estoque errado no WooCommerce acontece quando a quantidade exibida não bate com o real: produto disponível aparece esgotado, a contagem não baixa após a venda, ou somem unidades sem pedido. Quase sempre vem de cache antigo, de pedidos presos reduzindo estoque, ou de sincronização externa fora de hora.

Crítico

Como corrigir checkout do WooCommerce que não funciona

O checkout do WooCommerce não funcionar significa que o cliente chega à página de finalizar compra mas não consegue concluir: o botão de finalizar pedido não responde, a página recarrega sem avançar ou retorna erro. Quase sempre vem de conflito de plugin/tema, de requisições AJAX bloqueadas ou da página de checkout configurada errada.

Grave

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.

Crítico

Como corrigir o carrinho do WooCommerce que não funciona com o Elementor Pro

O cart do WooCommerce não funcionar com o Elementor Pro significa que o widget Menu Cart ou Cart mostra o contador parado em zero, não abre o painel lateral ou não soma o produto após o clique. Quase sempre vem dos fragments AJAX bloqueados por cache, do script wc-cart-fragments minificado, ou do tema sem suporte ao WooCommerce.

Setores

Extensões

Integrações

Como corrigir o produto do WooCommerce com página em branco

O que é o produto do WooCommerce com página em branco?

Como identificar

Como prevenir

Causa

Como resolver

Perguntas frequentes

Itens relacionados

Como corrigir o filtro de produtos do WooCommerce no JetSmartFilters

Como corrigir email de pedido do WooCommerce não enviado

Como corrigir o estoque do WooCommerce mostrando errado

Como corrigir checkout do WooCommerce que não funciona

Como corrigir a página de produto do WooCommerce que quebra com o Astra Pro

Como corrigir o carrinho do WooCommerce que não funciona com o Elementor Pro

Setores

Extensões

Integrações

Extensões

Hero Sections

Seções de CTA

Login

Blog

Cabeçalhos

Seções de FAQ

Cadastro

Blog individual

Rodapés

Seções de contato

Seções de preços

Faixas

Portfólio

Seções de equipe

Números

Logotipos