Correções rápidas
Tente estas primeiro — elas resolvem a maioria dos problemas:| Problema | O que tentar |
|---|---|
| Alterações não aparecem no telefone | Agite o telefone para abrir o menu Expo e toque em Reload |
| Alterações não aparecem no preview | Pressione R no console para fazer o rebundle |
| App travado ou sem resposta | Pare e reinicie o app pelo console |
Problemas comuns
As alterações não aparecem no meu dispositivo
As alterações não aparecem no meu dispositivo
Quando você faz alterações mas não as vê no telefone:
- Agite o telefone para abrir o menu do desenvolvedor Expo
- Toque em Reload para baixar o bundle novamente
Tela de erro vermelha no Expo Go
Tela de erro vermelha no Expo Go
Uma tela de erro vermelha geralmente indica um erro de JavaScript ou módulo ausente. Leia a mensagem de erro — ela frequentemente aponta para o arquivo e a linha específicos.Causas comuns:
- Um pacote não está instalado ou está na versão errada
- Um módulo funciona na web mas não no nativo (ou vice-versa)
- Erro de sintaxe no seu código
- Leia a mensagem de erro com atenção — ela frequentemente diz exatamente o que está errado
- Peça ao Agent para ajudar a corrigir o erro compartilhando a mensagem
- Se o erro mencionar um pacote específico, tente reinstalar as dependências (veja Reinstalar pacotes)
O app funciona na web mas trava no telefone (ou vice-versa)
O app funciona na web mas trava no telefone (ou vice-versa)
Alguns pacotes ou recursos funcionam de forma diferente entre plataformas. O React Native compila para três alvos: iOS, Android e web. Uma biblioteca que funciona na web pode não suportar o nativo, ou pode precisar de configuração diferente.O que tentar:
- Verifique se o pacote suporta sua plataforma na documentação dele
- Pergunte ao Agent: “Este pacote é compatível com o Expo Go?”
- Considere mover a funcionalidade para o seu servidor se não for suportada no mobile
O QR code não escaneia ou o app não conecta
O QR code não escaneia ou o app não conecta
Verifique sua rede:
- Seu telefone e computador devem estar na mesma rede WiFi
- Algumas redes corporativas ou públicas bloqueiam a conexão
npx expo start --tunnel no shell.Reinicie o Expo Go:
Feche completamente o Expo Go e reabra-o antes de escanear.O build demora muito
O build demora muito
O primeiro build é sempre mais lento porque não há cache. Builds subsequentes devem ser mais rápidos.O que afeta o tempo de build:
- Número de pacotes no seu projeto
- Primeira execução após limpar o cache
- Velocidade da rede ao baixar pacotes
Erros de módulo não encontrado
Erros de módulo não encontrado
Quando você vê “Unable to resolve module” ou “Module not found”:
- O pacote pode não estar instalado — peça ao Agent para instalá-lo
- O pacote pode estar instalado mas o cache está desatualizado — limpe o cache
- O pacote pode não existir ou estar com nome incorreto — verifique o nome do pacote
Comandos de depuração
Quando as correções rápidas não funcionam, esses comandos ajudam a redefinir vários caches e estados. Execute-os no Shell.Limpar o cache do Metro
O Metro é o bundler que compila seu código React Native. Limpar o cache força um build novo. No shell, execute:Reinstalar pacotes
Se você estiver vendo erros de módulo ou incompatibilidades de versão, reinstalar os pacotes frequentemente ajuda. No shell, execute:package.json.
Se o seu projeto usar um gerenciador de pacotes diferente (como
bun ou pnpm), use o comando de instalação apropriado: bun install ou pnpm install.Verificar incompatibilidades de versão
O Expo Doctor verifica seu projeto em busca de problemas comuns como incompatibilidades de versão entre pacotes. No shell, execute:Reset completo
Quando nada mais funciona, um reset completo limpa todos os caches e reinstala tudo.Opção nuclear: Comando de reset completo
Opção nuclear: Comando de reset completo
Este comando remove todos os caches e reinstala os pacotes do zero. Use-o como último recurso.O que isso faz:
rm -rf node_modules— Exclui os pacotes instaladosrm -rf .expo— Exclui o cache local do Exponpm cache clean --force— Limpa o cache global do npmnpm install— Reinstala todos os pacotesnpx expo start --clear— Inicia com um cache Metro novo
Limpar cache no seu dispositivo
Se o app no seu telefone parecer travado com código antigo mesmo após recarregar:- iOS: No Expo Go, vá para Settings e toque em Clear Cache
- Android: Vá para Settings > Apps > Expo Go > Storage > Clear Cache
Referência rápida
| Problema | Tente primeiro | Depois tente |
|---|---|---|
| Alterações não aparecem | Agite o telefone → Reload | Limpar cache do Metro |
| Erros de bundler | npx expo start --clear | Excluir node_modules |
| Módulo não encontrado | Reinstalar dependências | Reset completo |
| Avisos de incompatibilidade de versão | Execute npx expo-doctor | Avalie as correções sugeridas |
| Novo pacote não funcionando | Reinicie o servidor | Limpar cache do Metro |
| app.json alterado | Reinicie o servidor | — |
Obtendo mais ajuda
Se você ainda estiver com dificuldades:- Pergunte ao Agent: Descreva o erro e o que você tentou. O Agent frequentemente consegue diagnosticar e corrigir problemas.
- Consulte os docs do Expo: O guia de solução de problemas do Expo abrange cenários adicionais.
- Pesquise o erro: Copie a mensagem de erro exata e pesquise — alguém provavelmente já encontrou o mesmo problema.
Próximos passos
- Voltar para Apps Mobile Nativos
- Aprenda o fluxo completo de publicação: Criar e lançar um app mobile