Domande frequenti e risoluzione dei problemi

Questa pagina fornisce risposte alle domande frequenti su App Hosting.

Domande frequenti su App Hosting

Limitazioni e risoluzione dei problemi generali di App Hosting

  • A causa di un problema nell'infrastruttura di Cloud Run, la creazione o l'aggiornamento delle risorse potrebbe essere più lento del previsto in alcune regioni come us-central1. Se la latenza di deployment è un problema in una determinata regione, Google consiglia di eseguire il deployment in un'altra regione.
  • La CDN di App Hosting può includere solo un insieme specifico di intestazioni della richiesta nelle chiavi della cache. Questo elenco include le intestazioni RSC, Next-Router-State-Tree, Next-Router-Prefetch, Next-Router-Segment-Prefetch e Next-Url di NextJS, nonché le intestazioni standard 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 di Cloud CDN. Se una risposta contiene un'intestazione Vary con un valore non elencato qui, la nostra CDN non la memorizzerà nella cache.
  • I file statici non memorizzati nella cache vengono pubblicati da Cloud Run; in una versione successiva, verranno archiviati e pubblicati dall'origine App Hosting per prestazioni migliori.
  • La console Firebase potrebbe mostrare a intermittenza un errore "build non trovata e non valida" durante la creazione del backend.
  • Tutti i backend nello stesso progetto condividono un'organizzazione/un account GitHub. Possono essere collegati a repository diversi nell'organizzazione/nell'account. Per creare backend connessi a diversi account GitHub, inseriscili in progetti separati.

Limitazioni e risoluzione dei problemi delle app Angular

Sebbene il supporto di App Hosting per Angular sia in fase di sviluppo attivo e in espansione, presenta le seguenti limitazioni:

  • Internazionalizzazione: sebbene la funzionalità principale di internazionalizzazione funzioni, la navigazione diretta alle pagine SSR può generare errori.
  • Localizzazione: la creazione di versioni per impostazioni internazionali diverse non è supportata.
  • Builder: al momento è supportato solo il builder di applicazioni.
  • Ambienti e strumenti Monorepo: i progetti Angular con più di un target di applicazione non andranno a buon fine. Per un supporto più completo dei monorepo, utilizza Nx.

Errori HTTP 400 e attendibilità del proxy in Angular SSR

Se la tua applicazione Angular di cui è stato eseguito il deployment su Firebase App Hosting riscontra errori HTTP 400 (Richiesta errata), blocchi di convalida dell'host o errori di attendibilità del proxy, segui la soluzione consigliata per la tua versione di Angular:

  • Angular v19, v20 e v21: hai due modi per risolvere questi errori HTTP 400:
    • Esegui l'upgrade delle dipendenze: esegui npm update @angular/core @angular/ssr per installare l'ultima patch per la tua versione attuale di Angular.
    • Configurazione manuale: applica un fallback della configurazione a livello di codice impostando trustProxyHeaders: true nella configurazione del server (vedi Configurazione delle intestazioni proxy attendibili nella documentazione di Angular).
  • Angular v22: la prima build su un nuovo backend potrebbe restituire errori 400. Per risolvere il problema, genera una seconda build. Tutte le build successive dovrebbero funzionare come previsto.

Limitazioni e risoluzione dei problemi di Next.js