Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Perguntas frequentes e solução de problemas

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

App Hosting FAQ

O App Hosting é compatível com frameworks que não sejam Next.js e Angular?

O App Hosting oferece suporte pré-configurado para build e implantação do Next.js e do Angular, em que nos comprometemos a entender esses frameworks e interpretar as configurações nativas deles. Para vários outros frameworks, a comunidade de desenvolvedores oferece suporte a 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 poderá garantir o sucesso. Consulte Integração de framework.

Em quais regiões o Firebase App Hosting está disponível?

As regiões para App Hosting provavelmente vão aumentar com o tempo. Consulte Locais do App Hosting para informações 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 a outros provedores está no roteiro de longo prazo do App Hosting.

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

Se o repositório não aparecer na lista de opções ao criar um novo back-end no console 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 isso, acesse seu perfil do GitHub e selecione Configurações e depois Aplicativos. Na linha da tabela para o aplicativo Firebase App Hosting, clique em Configurar para gerenciar repositórios.

Por que meu site não aparece normalmente na WebView do app Android para dispositivos móveis?

Os apps que configuraram um domínio personalizado com o console Firebase antes do terceiro trimestre de 2025 podem notar que o site não é exibido corretamente no WebView do Android. Isso acontece 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 A e um TXT para o domínio e um 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 App Hosting?

No momento, não é possível mudar o repositório. No entanto, você pode criar um novo back-end associado ao repositório preferido no mesmo projeto ou criar um novo back-end em um projeto separado.

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

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

Existe um emulador para desenvolvimento local com 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 em 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-oath e a conexão que começa com apphosting-github-conn-. Ao abrir App Hosting no console Firebase, você poderá configurar uma nova conexão do GitHub.

Como posso definir cookies para meu site 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 do App Hosting e solução de problemas

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 de 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, além dos cabeçalhos padrão do Cloud CDN 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. Se uma resposta contiver um cabeçalho Vary com um valor não listado aqui, nossa CDN não o armazenará em cache.
Os arquivos estáticos sem cache são veiculados de Cloud Run. Em uma versão posterior, eles serão armazenados e veiculados da origem App Hosting para melhorar o desempenho.
O console Firebase pode mostrar intermitentemente um erro "build was not found and is invalid" (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. Elas podem ser conectadas a diferentes repositórios nessa organização/conta. Para criar back-ends conectados a diferentes contas do GitHub, coloque-os em projetos separados.

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

Embora o suporte do App Hosting para Angular esteja em desenvolvimento e 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: projetos do Angular com mais de um destino de aplicativo vão falhar. Para uma compatibilidade mais completa com monorepos, use o Nx.

Erros HTTP 400 e confiança de proxy na renderização do lado do servidor do Angular

Se o aplicativo Angular implantado em 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 fallback de configuração no nível do código definindo trustProxyHeaders: true na configuração do servidor. Consulte 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. Todos os builds subsequentes devem funcionar conforme o esperado.

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

Por padrão, a otimização de imagens integrada do NextJS fica desativada no App Hosting, a menos que você defina explicitamente images.unoptimized como "false" ou use um carregador de imagens personalizado. Consulte Otimizar o carregamento de imagens no Next.js.
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 o roteamento paralelo do Next.js.
No momento, o App Hosting limita o armazenamento em cache para apps NextJS usando middleware. Com o tempo, as taxas de ocorrência em cache vão melhorar.
Os caminhos de URL que contêm caracteres codificados por porcentagem são decodificados pelo Cloud Run. Isso pode causar problemas com recursos que esperam apenas caminhos de URL codificados, como o roteamento paralelo do Next.js.

Perguntas frequentes e solução de problemas Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.