FAQ et dépannage

Cette page répond aux questions fréquentes sur App Hosting.

App Hosting Questions fréquentes

App Hosting est-il compatible avec d'autres frameworks que Next.js et Angular ?

App Hosting fournit une assistance préconfigurée pour la compilation et le déploiement de Next.js et Angular, pour lesquels nous nous engageons à comprendre ces frameworks et à interpréter leurs configurations natives. Pour un certain nombre d' autres frameworks, la communauté des développeurs prend en charge les adaptateurs de framework App Hosting. De plus, pour toute application Node.js avec un script de compilation et de démarrage, App Hosting tentera de compiler, mais ne peut pas garantir le succès de manière fiable. Consultez Intégration de framework.

Quelles sont les régions compatibles avec Firebase App Hosting ?

Les régions pour App Hosting devraient s'étendre au fil du temps. Pour obtenir les informations les plus récentes, consultez les emplacements App Hosting.

Puis-je utiliser GitLab ou d'autres fournisseurs Git que GitHub pour les déploiements ?

Pour le moment, vous ne pouvez pas, mais la compatibilité avec d'autres fournisseurs est prévue à long terme pour App Hosting.

Pourquoi ne puis-je pas trouver mon dépôt dans l'interface utilisateur de la console Firebase ?

Si votre dépôt n'apparaît pas dans la liste des options lorsque vous créez un backend dans la console Firebase, essayez d'abord de sélectionner Actualiser la liste. Si le dépôt de votre choix n'est toujours pas disponible, vous devrez peut-être l'ajouter à l'aide de l'option Accorder l'accès à un nouveau dépôt dans GitHub.

Vous pouvez également gérer les dépôts avec l'application GitHub Firebase App Hosting. Pour ce faire, accédez à votre profil GitHub, puis sélectionnez Settings (Paramètres), puis Applications. Dans le tableau, sur la ligne de l'application Firebase App Hosting, cliquez sur Configurer pour gérer les dépôts.

Pourquoi mon site ne s'affiche-t-il pas normalement dans la WebView de l'application mobile Android ?

Il est possible que les applications ayant configuré un domaine personnalisé avec la console Firebase avant le troisième trimestre 2025 constatent que le site ne s'affiche pas correctement dans Android WebView. Cela se produit, car les enregistrements CNAME utilisés pendant cette période n'étaient pas compatibles avec Android WebView.

Pour résoudre ce problème, supprimez le domaine personnalisé du backend App Hosting et ajoutez-le à nouveau. La nouvelle interface utilisateur de la console fournira trois nouveaux enregistrements : un enregistrement A et un enregistrement TXT pour le domaine, ainsi qu'un enregistrement CNAME pour le sous-domaine du défi ACME (pour les certificats). Utilisez ces enregistrements à la place de l'enregistrement CNAME précédent.

Comment modifier le dépôt associé à mon projet App Hosting ?

Dans la console Firebase, ouvrez votre backend App Hosting, puis accédez à Settings > Deployment (Paramètres > Déploiement). Dans la section Dépôt GitHub, vous pouvez déconnecter le dépôt actuel ou sélectionner un autre dépôt connecté à votre projet.

Comment définir des en-têtes pour mon site App Hosting ?

Les en-têtes dépendent du framework. Faites ce que vous feriez normalement pour votre framework.

Existe-t-il un émulateur pour le développement local avec App Hosting ?

Oui, vous pouvez effectuer des tests locaux de votre application avant le déploiement de App Hosting à l'aide de l'émulateur App Hosting, qui fait partie de la suite d'émulateurs locaux Firebase. Consultez Tester le déploiement de votre application en local .

Pourquoi des erreurs s'affichent-elles dans App Hosting, mais pas dans Cloud Build ?

Dans ce cas, il est possible que l'erreur provienne de Cloud Run. Vérifiez l'état du déploiement pour en être sûr.

Comment modifier ou supprimer un compte GitHub associé ?

Pour supprimer le compte GitHub associé, ouvrez Developer Connect, assurez-vous que votre projet est sélectionné, puis supprimez la connexion firebase-app-hosting-github-oauth et celle qui commence par apphosting-github-conn-. Lorsque vous ouvrez App Hosting dans la console Firebase, vous devriez maintenant pouvoir configurer une nouvelle connexion GitHub.

Comment puis-je définir des cookies pour mon site App Hosting ?

Bien qu'il n'ait pas été disponible lors du lancement de l'aperçu App Hosting, l'en-tête de réponse HTTP Set-Cookie fonctionne désormais comme prévu.

Limites et dépannage généraux App Hosting

• En raison d'un problème dans l'infrastructure Cloud Run, la création ou la mise à jour de ressources peut être plus lente que prévu dans certaines régions, comme us-central1. Si la latence de déploiement pose problème dans une région spécifique, Google recommande de déployer dans une autre région.
• Le CDN de App Hosting ne peut inclure qu'un ensemble spécifique d'en-têtes de requête dans ses clés de cache. Cette liste inclut les en-têtes RSC, Next-Router-State-Tree, Next-Router-Prefetch, Next-Router-Segment-Prefetch et Next-Url de NextJS, ainsi que les en-têtes standards 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 et X-Origin de Cloud CDN. Si une réponse contient un en-tête Vary avec une valeur qui ne figure pas dans la liste ci-dessus, notre CDN ne la mettra pas en cache.
• Les fichiers statiques non mis en cache sont diffusés à partir de Cloud Run. Dans une version ultérieure, ils seront stockés et diffusés à partir de l'origine App Hosting pour améliorer les performances.
• La console Firebase peut afficher par intermittence une erreur "build was not found and is invalid" (compilation introuvable et non valide) lors de la création du backend.
• Tous les backends d'un même projet partagent une organisation ou un compte GitHub. Ils peuvent être associés à différents dépôts de cette organisation ou de ce compte. Pour créer des backends associés à différents comptes GitHub, placez-les dans des projets distincts.

Limites et dépannage des applications Angular

Bien que la compatibilité de App Hosting avec Angular soit en cours de développement et d'expansion, elle présente les limites suivantes :

• I18n : bien que la fonctionnalité I18n de base fonctionne, la navigation directe vers les pages SSR peut entraîner des erreurs.
• Localisation : la création de versions pour différentes langues n'est pas prise en charge.
• Builders : seul le générateur d'applications est actuellement compatible.
• Environnements et outils Monorepo : les projets Angular comportant plusieurs cibles d'application échoueront. Pour une prise en charge plus complète des monorepos, utilisez Nx.

Erreurs HTTP 400 et confiance du proxy dans Angular SSR

Si votre application Angular déployée sur Firebase App Hosting rencontre des erreurs HTTP 400 (requête incorrecte), des bloqueurs de validation d'hôte ou des échecs de confiance du proxy, suivez la solution recommandée pour votre version d'Angular :

• Angular v19, v20 et v21 : vous avez deux façons de résoudre ces erreurs HTTP 400 :
  • Mettez à niveau les dépendances : exécutez npm update @angular/core @angular/ssr pour installer la dernière version corrective de votre version actuelle d'Angular.
  • Configuration manuelle : appliquez un remplacement de configuration au niveau du code en définissant trustProxyHeaders: true dans la configuration de votre serveur (consultez Configurer les en-têtes de proxy de confiance dans la documentation Angular).
• Angular v22 : la première compilation sur un nouveau backend peut renvoyer des erreurs 400. Pour résoudre le problème, générez une deuxième version. Toutes les versions ultérieures devraient fonctionner comme prévu.

Limites et dépannage de Next.js

• Par défaut, l'optimisation d'image NextJS intégrée est désactivée sur App Hosting, sauf si vous définissez explicitement images.unoptimized sur "false" ou si vous utilisez un chargeur d'image personnalisé. Consultez Optimiser le chargement des images sur Next.js.
• Actuellement, App Hosting limite la mise en cache des applications NextJS à l'aide du middleware. Au fil du temps, les taux de succès de cache devraient s'améliorer.
• Les chemins d'URL contenant des caractères encodés en pourcentage sont décodés par Cloud Run. Cela peut entraîner des problèmes avec les fonctionnalités qui n'attendent que des chemins d'URL encodés, comme le routage parallèle Next.js.