Página em branco no seu site: árvore de decisão de triagem para fundadores

O que uma “página em branco” geralmente significa

Uma “página em branco” nem sempre é uma tela branca literal. Às vezes aparece um cabeçalho sem conteúdo, um spinner que não termina, ou um painel onde o layout carrega mas os cards ficam vazios.

O erro que a maioria dos fundadores comete é tentar correções aleatórias (atualizar várias vezes, limpar tudo, mexer no código) antes de saber que tipo de problema é. Uma triagem rápida transforma um sintoma assustador em um rótulo claro: navegador, conta ou servidor/build.

Antes de tocar em qualquer coisa, gaste dois minutos reunindo sinais.

Tenha isso pronto:

• A URL exata da página onde acontece
• Uma janela anônima/privada
• Um segundo navegador (ou o mesmo navegador em outro dispositivo)
• Um login de conta afetada (e, idealmente, uma segunda conta)
• Uma nota curta sobre o que você vê (tela branca, spinner travado, layout meia carregado)

O que você quer descobrir:

• Funciona em incógnito, falha no modo normal: cookies, cache, extensões ou estado local do navegador
• Falha em vários navegadores/dispositivos: build, deploy, backend ou um crash client-side que afeta todos
• Falha apenas para uma conta: permissões, dados do usuário, papéis/feature flags ou uma resposta de API específica do usuário

Exemplo: se um fundador vê um painel em branco após o login, mas um colega consegue carregar, você já tende a “específico da conta”, não “site fora do ar”.

Capture o básico antes de mudar qualquer coisa

Boas notas resolvem problemas mais rápido do que cliques frenéticos.

Escreva o que você esperava versus o que realmente viu. “O painel deveria mostrar meus projetos” é acionável. “Está quebrado” não é.

Os detalhes mínimos que salvam horas depois:

• URL exata (copie da barra de endereço)
• Horário em que aconteceu (inclua fuso se puder)
• O que você esperava vs o que aconteceu
• Dispositivo e navegador (Mac Chrome, iPhone Safari)
• Rede (Wi‑Fi de casa, Wi‑Fi do escritório, hotspot)

Faça uma captura de tela mesmo que pareça “nada”. Uma tela branca, um spinner preso e um cabeçalho ausente normalmente apontam para causas diferentes.

Atualize a página uma vez, e pare. Loops rápidos de atualização podem disparar limites de taxa, deslogar usuários ou colocar o app em um estado diferente.

Passo 1: Teste em modo anônimo

O modo anônimo/privado é a forma mais rápida de separar “meu navegador está confuso” de “o app quebrou”. Ele começa com uma sessão limpa.

Faça isto:

• Abra uma janela anônima/privada
• Cole a mesma URL exata
• Se a página requer login, entre e repita a ação que leva à tela em branco
• Anote o que acontece (carrega, fica em branco, pisca e depois some)
• Copie qualquer mensagem de erro exatamente

Como interpretar o resultado:

• Se funcionar em incógnito, suspeite de cookies (sessão ruim), arquivos em cache (JavaScript antigo), valores em local storage ou uma extensão interferindo.
• Se continuar em branco em incógnito, não perca tempo limpando caches ainda. Você já aprendeu que provavelmente não é só seus cookies existentes.

Passo 2: Teste em outro navegador (e mais um dispositivo, se puder)

Em seguida, teste a mesma URL em um navegador diferente. Alguns problemas de “página em branco” são específicos de navegador mesmo quando o servidor está ok.

Mantenha o teste limpo: mesma conexão, mesmos passos, sem mudanças extras.

Uma ordem simples que funciona:

• Abra a página em um segundo navegador que você não usa normalmente
• Tente uma janela privada nesse segundo navegador
• Verifique a página no seu celular
• Se possível, teste o celular em dados móveis (desative o Wi‑Fi)

Padrões para observar:

• Falha em apenas um navegador: extensão, armazenamento bloqueado, ativo em cache ou peculiaridade do navegador
• Falha em todos os navegadores no mesmo laptop: menos provável ser uma peculiaridade do navegador
• Funciona em dados móveis, mas não na Wi‑Fi do escritório: VPN, filtragem DNS ou firewall/proxy corporativo
• Falha em todos os dispositivos e redes: deploy/build/backend ou um crash frontend que atinge todos

Mantenha um log de teste em uma linha para não entrar em loop: “Chrome Mac (Wi‑Fi): em branco. Safari Mac (Wi‑Fi): carrega. iPhone (dados móveis): carrega.”

Passo 3: Verifique se só uma conta é afetada

Agora retire a “minha conta” da equação.

1. Faça logout e carregue qualquer página pública primeiro (home, pricing, página de marketing). Se páginas públicas funcionam mas a área do app fica em branco após o login, o problema frequentemente envolve autenticação, permissões ou uma chamada de API pós-login.

2. Compare contas. Peça a um colega que faça login e carregue a mesma página.

3. Se puder, tente uma conta de teste nova. Contas novas normalmente têm dados limpos, o que ajuda a revelar se um registro de usuário está disparando o crash.

Leitura rápida do resultado:

• Funciona para outras contas, falha só para a sua: sessão/cookies, registro de usuário corrompido, bug de papel/permissão, ou uma página que não lida com seus dados específicos
• Falha para várias contas: falha compartilhada de backend/API, crash frontend em um caminho comum, ou um deploy ruim
• Páginas públicas carregam mas áreas do app ficam em branco: fluxo de auth ou uma requisição pós-login falhando

Exemplo: se o painel fica em branco apenas para uma conta admin, um widget exclusivo de admin pode estar fazendo uma chamada de API que falha e derruba a página inteira.

Se funciona em incógnito: cookies, cache e extensões

Se em incógnito funciona, provavelmente o servidor está ok. Foque no que é diferente no seu navegador normal: sessão armazenada, arquivos em cache, extensões ou configurações de privacidade do navegador.

Comece pequeno. Corrija só o domínio, não todo o navegador.

Correções seguras, em ordem

Tente uma mudança de cada vez e reteste após cada uma:

• Limpe os dados do site apenas para o seu domínio (cookies e local storage), depois entre novamente
• Hard refresh (recarregar sem usar cache)
• Desative extensões, depois reative uma a uma para achar a culpada (ad blockers e bloqueadores de script são comuns)
• Desative temporariamente proteção rígida contra rastreamento para um teste rápido, depois ligue de novo
• Tente um perfil novo do navegador (ou modo convidado) para confirmar que está ligado ao seu perfil habitual

O que evitar:

• Não “limpe todos os dados de navegação” como primeira atitude. Isso apaga pistas úteis e desloga você em todos os lugares.
• Não mude código do app se incógnito funciona. Você provavelmente está perseguindo a categoria errada de problema.

Quando encontrar o gatilho (uma extensão, um reset de cookie, uma configuração de privacidade), anote. Esse detalhe geralmente evita repetições.

Se falha em todos: provavelmente problema de servidor ou build

Se está em branco em incógnito, em outro navegador e em outro dispositivo, trate como problema do aplicativo até prova em contrário.

Primeiro, descarte um caso de borda de rede trocando a rede (hotspot do celular em vez da Wi‑Fi do escritório). Se isso resolver, suspeite de regras de firewall, filtragem DNS, VPNs ou proxies.

Depois, separe “não consegue alcançar o site” de “o site carrega mas o app não renderiza”:

• Se o domínio não resolve ou você não consegue carregar nada, pense em DNS, hospedagem ou certificado.
• Se dá para ver a concha (cabeçalho/layout) mas a área principal está vazia, pense em crash frontend ou falha de API.

Então procure mudanças recentes. Telas em branco muitas vezes começam logo após um deploy, uma atualização de variável de ambiente, mudança no provedor de auth ou uma edição de configuração feita às pressas.

Se você tem acesso a logs, foque na hora exata em que reproduziu. Pistas comuns:

• Pico de erros 500
• “Failed to fetch” ou erros de CORS
• Falhas na verificação de tokens/auth
• Variáveis de ambiente faltando durante o build
• Timeouts de banco de dados ou erros de conexão

Armadilhas comuns que fazem perder tempo

Páginas em branco parecem urgentes, então as pessoas começam a fazer tudo de uma vez. É assim que você perde o sinal.

As maiores perdas de tempo:

• Loops de atualização que não mudam nada e não ensinam nada
• Mudar várias variáveis ao mesmo tempo (limpar cache, deslogar, desativar extensões, redeploy) para que você não saiba o que importou
• Testar só com sua conta admin e perder um bug específico de papel ou dado de usuário
• Esquecer a última mudança real (deploy, plugin, atualização de env var, configuração de auth)

Uma regra útil: mude uma coisa, observe, escreva.

Checklist de 5 minutos para estreitar o problema

Responda isto em ordem e registre cada resultado:

• Teste em incógnito: carrega em uma janela privada após logar novamente?
• Teste de navegador: carrega em outro navegador?
• Teste de conta: carrega para outro usuário (ou usuário de teste novo)?
• Teste de dispositivo/rede: carrega em um segundo dispositivo ou em outra rede (hotspot serve)?
• Evidência: você tem a URL exata, timestamp e captura de tela?

Como agir segundo o padrão:

• Funciona só em incógnito: algo no seu navegador normal está interferindo (cookies, cache, extensão, local storage)
• Falha em dois navegadores e duas redes: pare com correções locais e investigue deploy/build/backend/frontend crash
• Falha apenas para uma conta: foque em dados específicos do usuário, papéis/permissões e registros de borda

Quando escalar, envie fatos: a URL, o horário, os testes que você rodou, o que esperava, o que viu e qualquer texto de erro do console que você conseguir copiar.

Exemplo: painel em branco para um usuário vs para todos

Uma situação comum: páginas de marketing carregam, mas o painel fica em branco logo após o login.

Cenário A: apenas uma conta

Você vê uma tela branca. Em incógnito funciona. Em outro navegador funciona.

Isso é um problema de estado local (cookie/sessão/bundle em cache/extensão) ou algo ligado às configurações da sua conta que sua sessão normal lê de forma diferente. Pare quando conseguir reproduzir o padrão consistentemente e escale com as evidências.

Cenário B: a maioria dos usuários

Incógnito está em branco. Um segundo navegador está em branco. Outro dispositivo ou colega vê o mesmo.

Isso aponta para um deploy/build/backend ou um crash frontend numa rota comum. Não envie palpites. Envie uma nota de reprodução curta:

• URL exata e qual tela está em branco
• Quais testes você rodou (incógnito, navegador, dispositivo) e os resultados
• Se é uma conta ou várias
• Quando começou e o que mudou recentemente
• Captura de tela e qualquer texto de erro do console

Próximos passos: escale com clareza (e quando chamar a FixMyMess)

Se a página em branco aparece em vários navegadores/dispositivos, trate como um outage. Foque em velocidade e clareza, não em mais experimentos.

Escale imediatamente se:

• Novos cadastros não conseguem completar
• Login falha para muitos usuários
• Checkout/pagamentos falham
• O app está em branco em vários dispositivos e redes
• O problema começou logo após um deploy ou mudança de variável de ambiente

Peça três coisas: o que está falhando, por que começou e o que será mudado para consertar (mais como a correção será verificada).

Se o app foi gerado por ferramentas como Lovable, Bolt, v0, Cursor ou Replit, telas em branco costumam ser causadas por fluxos de auth frágeis, segredos faltando ou expostos (env vars) ou incompatibilidades de build/deploy que só aparecem em produção. Nesses casos, um diagnóstico externo rápido pode sair mais barato do que chutes durante um incidente. FixMyMess (fixmymess.ai) oferece uma auditoria de código gratuita e foca em transformar protótipos gerados por IA em software pronto para produção, incluindo reparo de lógica, reforço de segurança e preparação para deploy.