Perguntas frequentes e solução de problemas

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

Perguntas frequentes sobre App Hosting

O App Hosting oferece suporte a frameworks diferentes do Next.js e do Angular?

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, App Hosting vai tentar builds, mas não pode garantir o sucesso. Consulte Integração de frameworks.

Quais regiões o Firebase App Hosting oferece suporte?

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

Posso usar o GitLab ou outros provedores 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 para 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 Firebase console, selecione Atualizar lista. Se o repositório preferido ainda não estiver disponível, adicione-o usando a opção Conceder acesso a um novo repositório no GitHub.

Além disso, é possível gerenciar repositórios com o Firebase App Hosting aplicativo do GitHub. Para fazer isso, acesse seu perfil do GitHub e selecione Configurações e Aplicativos. Na linha da tabela do 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 Firebase console antes do terceiro trimestre de 2025 podem descobrir que o site não é exibido corretamente na WebView do Android. Isso ocorre porque os registros CNAME usados durante esse período não eram compatíveis com a WebView do Android.

Para resolver esse problema, remova o domínio personalizado do App Hosting back-end 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 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 App Hosting projeto?

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 faço para definir cabeçalhos para meu site App Hosting?

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

Há um emulador para desenvolvimento local com App Hosting?

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

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, selecione seu projeto e exclua a firebase-app-hosting-github-oath conexão 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 faço para definir cookies para meu App Hosting site?

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

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

• Devido a um problema na infraestrutura, a criação ou atualização de recursos pode ser mais lenta do que o esperado em algumas regiões, como us-central1.Cloud Run Se a latência de implantação for um problema em uma região específica, o Google recomenda a implantação em outra região.
• O CDN de App Hosting só pode incluir um conjunto específico de cabeçalhos de solicitação em suas 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 contiver um cabeçalho Vary com um valor não listado aqui, nosso CDN não vai armazená-lo em cache.
• Os arquivos estáticos não armazenados em cache são veiculados no Cloud Run. Em uma versão posterior, eles serão armazenados e veiculados na origem App Hosting para melhorar a performance.
• O console Firebase pode mostrar intermitentemente um erro "O build não foi 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 do app Angular

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

• I18n: embora a funcionalidade principal do I18n funcione, a navegação direta para páginas SSR pode resultar em erros.
• Localização: não há suporte para a criação de versões para diferentes locais.
• Builders: no momento, apenas o builder de aplicativos é compatível.
• Ambientes e ferramentas de monorepo: projetos do Angular que têm mais de um destino de aplicativo vão falhar. Para um suporte mais completo ao monorepo, 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 (Bad Request), 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 erros:
  • Faça 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 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. 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 imagem integrada do NextJS está 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 em 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, App Hosting limita o armazenamento em cache para apps NextJS que usam middleware. Com o tempo, as taxas de ocorrência em cache vão melhorar.
• Os caminhos de URL que contêm caracteres codificados em 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