Perguntas frequentes e solução de problemas

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

App Hosting Perguntas frequentes

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 de solicitação nas chaves de cache. A lista inclui:

    • Cabeçalhos do Next.js: RSC, Next-Router-State-Tree, Next-Router-Prefetch, Next-Router-Segment-Prefetch e Next-Url.

    • 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 tiver um cabeçalho Vary com um valor não listado aqui, a 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. Elas podem ser conectadas 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