Perguntas frequentes e solução de problemas

Esta página fornece respostas para perguntas frequentes sobre o App Hosting.

App Hosting Perguntas frequentes

O App Hosting é compatível com outros frameworks além do Next.js e do Angular?

O App Hosting oferece suporte pré-configurado de build e implantação para Next.js e Angular, em que nos comprometemos a entender esses frameworks e interpretar as configurações nativas deles. Para vários outros frameworks, o suporte da comunidade de desenvolvedores oferece adaptadores de framework App Hosting. Além disso, para qualquer aplicativo Node.js com um script de build e inicialização, o App Hosting tentará fazer builds, mas não pode garantir o sucesso de maneira confiável. Consulte Integração de framework.

Quais regiões são compatíveis com o Firebase App Hosting?

As regiões do App Hosting provavelmente vão aumentar com o tempo. Consulte Locais do App Hosting para ver as informações mais atualizadas.

Posso usar o GitLab ou outros provedores do Git além do GitHub para implantações?

No momento, não é possível, mas o suporte para outros provedores está no roteiro de longo prazo do App Hosting.

Por que não consigo encontrar meu repositório na interface do console do Firebase?

Se o repositório não aparecer na lista de opções ao criar um novo back-end no console do Firebase, tente selecionar Atualizar lista. Se o repositório preferido ainda não estiver disponível, talvez seja necessário adicioná-lo usando a opção Conceder acesso a um novo repositório no GitHub.

Além disso, é possível gerenciar repositórios com o aplicativo Firebase App Hosting do GitHub. Para fazer isso, acesse seu perfil do GitHub e selecione Configurações e, em seguida, Aplicativos. Na linha da tabela do aplicativo Firebase App Hosting, clique em Configurar para gerenciar repositórios.

Por que meu site não é exibido normalmente no WebView do app para dispositivos móveis Android?

Os apps que configuraram um domínio personalizado com o console do Firebase antes do terceiro trimestre de 2025 podem não ser exibidos corretamente no Android WebView. Isso ocorre porque os registros CNAME usados durante esse período não eram compatíveis com o Android WebView.

Para resolver esse problema, remova o domínio personalizado do back-end App Hosting e adicione-o novamente. A interface atualizada do console vai fornecer três novos registros: um registro A e um registro TXT para o domínio, além de um registro CNAME para o subdomínio de desafio ACME (para certificados). Use esses registros no lugar do registro CNAME anterior.

Como faço para mudar o repositório associado ao meu projeto do App Hosting?

No console do Firebase, abra o back-end do App Hosting e acesse Configurações > Implantação. Na seção Repositório do GitHub, é possível desconectar o repositório atual ou selecionar outro repositório conectado ao projeto.

Como posso definir cabeçalhos para meu site do App Hosting?

Os cabeçalhos dependem do framework. Faça o que você normalmente faria para seu framework.

Existe um emulador para desenvolvimento local com o App Hosting?

Sim, é possível realizar testes locais do app antes da implantação do App Hosting usando o emulador App Hosting, que faz parte do Pacote de emuladores locais do Firebase. Consulte Testar localmente a implantação do app.

Por que vejo erros no App Hosting, mas não no Cloud Build?

Nesses casos, é possível que o erro tenha vindo do Cloud Run. Verifique o status do lançamento para ter certeza.

Como faço para mudar ou remover uma conta do GitHub vinculada?

Para remover a conta do GitHub vinculada, abra o Developer Connect, verifique se o projeto está selecionado e exclua a conexão firebase-app-hosting-github-oauth e a conexão que começa com apphosting-github-conn-. Ao abrir App Hosting no console do Firebase, agora você poderá configurar uma nova conexão do GitHub.

Como posso definir cookies para meu site do App Hosting?

Embora não estivesse disponível no lançamento da prévia do App Hosting, o cabeçalho de resposta HTTP Set-Cookie agora funciona conforme o esperado.

Limitações gerais e solução de problemas do App Hosting

• Devido a um problema na infraestrutura do Cloud Run, a criação ou atualização de recursos pode ser mais lenta do que o esperado em algumas regiões, como us-central1. Se a latência de implantação for um problema em uma região específica, o Google recomenda implantar em outra região.
• A CDN do App Hosting só pode incluir um conjunto específico de cabeçalhos da solicitação nas chaves de cache. Essa lista inclui os cabeçalhos RSC, Next-Router-State-Tree, Next-Router-Prefetch, Next-Router-Segment-Prefetch e Next-Url do NextJS, bem como os cabeçalhos padrão Accept, Accept-Encoding, Access-Control-Request-Headers, Access-Control-Request-Method, Origin, Sec-Fetch-Dest, Sec-Fetch-Mode, Sec-Fetch-Site, X-Goog-Allowed-Resources e X-Origin do Cloud CDN. Se uma resposta tiver um cabeçalho Vary com um valor não listado aqui, nossa CDN não vai armazená-la em cache.
• Os arquivos estáticos não armazenados em cache são disponibilizados em Cloud Run. Em uma versão posterior, eles serão armazenados e disponibilizados na origem App Hosting para melhorar o desempenho.
• O console do Firebase pode mostrar de forma intermitente um erro "build não encontrado e inválido" na criação do back-end.
• Todos os back-ends no mesmo projeto compartilham uma organização/conta do GitHub. Eles podem ser conectados a diferentes repositórios nessa organização/conta. Para criar back-ends conectados a contas diferentes do GitHub, coloque-os em projetos separados.

Limitações e solução de problemas de apps do Angular

Embora o suporte do App Hosting para Angular esteja em desenvolvimento ativo e em expansão, ele tem as seguintes limitações:

• I18n: embora a funcionalidade principal de I18n funcione, a navegação direta para páginas SSR pode resultar em erros.
• Localização: não é possível criar versões para diferentes localidades.
• Builders: no momento, apenas o Application Builder é compatível.
• Ambientes e ferramentas de monorepo: os projetos do Angular que têm mais de um destino de aplicativo vão falhar. Para um suporte mais completo a monorepos, use o Nx.

Erros HTTP 400 e confiança de proxy no SSR do Angular

Se o aplicativo Angular implantado no Firebase App Hosting encontrar erros HTTP 400 (solicitação inválida), bloqueadores de validação de host ou falhas de confiança de proxy, siga a solução recomendada para sua versão do Angular:

• Angular v19, v20 e v21: há duas maneiras de resolver esses erros HTTP 400:
  • Fazer upgrade das dependências: execute npm update @angular/core @angular/ssr para instalar a versão de patch mais recente da sua versão atual do Angular.
  • Configuração manual: aplique um substituto de configuração no nível do código definindo trustProxyHeaders: true na configuração do servidor (consulte Como configurar cabeçalhos de proxy confiáveis na documentação do Angular).
• Angular v22: o primeiro build em um novo back-end pode retornar erros 400. Para resolver o problema, gere um segundo build. Todas as versões seguintes vão funcionar como esperado.

Limitações e solução de problemas do Next.js

• Por padrão, a otimização de imagem integrada do NextJS está desativada no App Hosting, a menos que você defina explicitamente images.unoptimized como falso ou use um carregador de imagens personalizado. Consulte Otimizar o carregamento de imagens no Next.js.
• Por padrão, o Next.js grava páginas e dados em cache no sistema de arquivos, o que conta para a memória de cada instância de exibição no App Hosting. Se as instâncias forem reiniciadas com erros Memory limit exceeded, consulte Configurar o armazenamento em cache do servidor no Next.js.
• Atualmente, o App Hosting limita o armazenamento em cache para apps NextJS usando middleware. Com o tempo, as taxas de ocorrência em cache devem melhorar.
• Os caminhos de URL que contêm caracteres codificados por porcentagem são decodificados por Cloud Run. Isso pode causar problemas com recursos que esperam apenas caminhos de URL codificados, como roteamento paralelo do Next.js.