Domande frequenti e risoluzione dei problemi

Questa pagina fornisce risposte alle domande frequenti (FAQ) su App Hosting.

Domande frequenti su App Hosting

Limitazioni generali e risoluzione dei problemi di App Hosting

  • A causa di un problema nell'Cloud Runinfrastruttura, la creazione o l'aggiornamento delle risorse potrebbe essere più lento del previsto in alcune regioni come us-central1. Se la latenza del 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-Origindi 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 release successiva, verranno archiviati e pubblicati dall'origine App Hostingper un rendimento migliore.
  • La console Firebase potrebbe mostrare a intermittenza un errore "build non trovata e non valida" durante la creazione del backend.
  • Tutti i backend dello stesso progetto condividono un'organizzazione/un account GitHub. Possono essere collegati a repository diversi all'interno di questa organizzazione/di questo account. Per creare backend collegati a account GitHub diversi, inseriscili in progetti separati.

Limitazioni e risoluzione dei problemi delle app Angular

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

  • I18n: sebbene la funzionalità I18n di base funzioni, la navigazione diretta alle pagine SSR può causare errori.
  • Localizzazione: la creazione di versioni per impostazioni internazionali diverse non è supportata.
  • Generatori: al momento è supportato solo il generatore di applicazioni.
  • Ambienti e strumenti monorepo: i progetti Angular con più di una destinazione dell'applicazione non andranno a buon fine. Per un supporto monorepo più completo, utilizza Nx.

Errori HTTP 400 e attendibilità del proxy in Angular SSR

Se l'applicazione Angular di cui hai 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 errors:
    • Aggiorna le dipendenze: esegui npm update @angular/core @angular/ssr per installare l'ultima patch release per la tua versione corrente di Angular.
    • Configurazione manuale: applica un fallback di configurazione a livello di codice impostando trustProxyHeaders: true nella configurazione del server (consulta Configurare le intestazioni del 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

  • Per impostazione predefinita, l'ottimizzazione delle immagini NextJS integrata è disattivata su App Hosting, a meno che tu non imposti esplicitamente images.unoptimized su false o utilizzi un Image Loader personalizzato. Consulta Ottimizzare il caricamento delle immagini su Next.js.
  • I percorsi URL contenenti caratteri con codifica percentuale vengono decodificati da Cloud Run. Ciò potrebbe causare problemi con le funzionalità che prevedono solo percorsi URL codificati, come il routing parallelo di Next.js.
  • Al momento, App Hosting limita la memorizzazione nella cache per le app NextJS che utilizzano il middleware. Nel tempo, le percentuali di successo della cache dovrebbero migliorare.
  • I percorsi URL contenenti caratteri con codifica percentuale vengono decodificati da Cloud Run. Ciò potrebbe causare problemi con le funzionalità che prevedono solo percorsi URL codificati, come il routing parallelo di Next.js