FAQ und Fehlerbehebung

Auf dieser Seite finden Sie Antworten auf häufig gestellte Fragen zu App Hosting.

App Hosting – Häufig gestellte Fragen

Werden in App Hosting auch andere Frameworks als Next.js und Angular unterstützt?

App Hosting bietet vorkonfigurierte Unterstützung für das Erstellen und Bereitstellen von Next.js- und Angular-Anwendungen. Wir haben uns verpflichtet, diese Frameworks zu verstehen und ihre nativen Konfigurationen zu interpretieren. Für eine Reihe anderer Frameworks werden App Hosting-Framework-Adapter von der Entwickler-Community unterstützt. Außerdem wird für jede Node.js-Anwendung mit einem Build- und Startskript mit App Hosting versucht, Builds zu erstellen. Der Erfolg kann jedoch nicht zuverlässig garantiert werden. Weitere Informationen finden Sie unter Framework-Integration.

In welchen Regionen wird Firebase App Hosting unterstützt?

Die Regionen für App Hosting werden wahrscheinlich im Laufe der Zeit erweitert. Die jeweils aktuellen Informationen finden Sie unter App Hosting-Standorte.

Kann ich für Bereitstellungen auch GitLab oder andere Git-Anbieter als GitHub verwenden?

Derzeit ist das nicht möglich, aber die Unterstützung anderer Anbieter ist langfristig für App Hosting geplant.

Warum kann ich mein Repository nicht in der Firebase Console finden? 

Wenn Ihr Repository beim Erstellen eines neuen Back-Ends in der Firebase Console nicht in der Liste der Optionen angezeigt wird, wählen Sie zuerst Liste aktualisieren aus. Wenn das bevorzugte Repository immer noch nicht verfügbar ist, müssen Sie es möglicherweise mit der Option Zugriff auf ein neues Repository in GitHub gewähren hinzufügen.

Außerdem können Sie Repositories mit der GitHub-Anwendung Firebase App Hosting verwalten. Rufen Sie dazu Ihr GitHub-Profil auf und wählen Sie Einstellungen und dann Anwendungen aus. Klicken Sie in der Tabellenzeile für die Firebase App Hosting-Anwendung auf Konfigurieren, um Repositorys zu verwalten.

Warum wird meine Website in WebView einer mobilen Android-App nicht normal angezeigt? 

Bei Apps, für die vor dem 3. Quartal 2025 eine benutzerdefinierte Domain in der Firebase Console konfiguriert wurde, wird die Website möglicherweise nicht richtig in Android WebView angezeigt. Das liegt daran, dass die in diesem Zeitraum verwendeten CNAME-Einträge nicht mit Android WebView kompatibel waren.

Entfernen Sie die benutzerdefinierte Domain aus dem App Hosting-Backend und fügen Sie sie noch einmal hinzu, um das Problem zu beheben. In der aktualisierten Console-Benutzeroberfläche werden drei neue Einträge angezeigt: ein A- und ein TXT-Eintrag für die Domain sowie ein CNAME für die ACME-Identitätsbestätigungs-Subdomain (für Zertifikate). Verwenden Sie diese Einträge anstelle des vorherigen CNAME-Eintrags.

Wie ändere ich das mit meinem App Hosting-Projekt verknüpfte Repository?

Derzeit ist es nicht möglich, das Repository zu ändern. Sie können jedoch ein neues Backend erstellen, das dem bevorzugten Repository im selben Projekt zugeordnet ist, oder ein neues Backend in einem separaten Projekt erstellen.

Wie kann ich Überschriften für meine App Hosting-Website festlegen?

Header sind frameworkabhängig. Führen Sie alle Schritte aus, die Sie normalerweise für Ihr Framework ausführen würden.

Gibt es einen Emulator für die lokale Entwicklung mit App Hosting?

Ja, Sie können Ihre App vor der Bereitstellung mit dem App Hosting-Emulator testen, der Teil der Firebase Local Emulator Suite ist.App Hosting Weitere Informationen finden Sie unter App-Bereitstellung lokal testen .

Warum sehe ich Fehler in App Hosting, aber nicht in Cloud Build?

In solchen Fällen kann es sein, dass der Fehler in Cloud Run aufgetreten ist. Prüfen Sie den Status des Rollouts, um sicherzugehen.

Wie kann ich ein verknüpftes GitHub-Konto ändern oder entfernen?

Wenn Sie das verknüpfte GitHub-Konto entfernen möchten, öffnen Sie Developer Connect, wählen Sie Ihr Projekt aus und löschen Sie die firebase-app-hosting-github-oath-Verbindung und die Verbindung, die mit apphosting-github-conn- beginnt. Wenn Sie App Hosting in der Firebase-Konsole öffnen, sollten Sie jetzt eine neue GitHub-Verbindung einrichten können.

Wie kann ich Cookies für meine App Hosting-Website festlegen?

Obwohl er bei der Einführung der App Hosting-Vorschau nicht verfügbar war, funktioniert der Set-Cookie-HTTP-Antwortheader jetzt wie erwartet.

Allgemeine Einschränkungen und Fehlerbehebung für App Hosting

• Aufgrund eines Problems in der Cloud Run-Infrastruktur kann das Erstellen oder Aktualisieren von Ressourcen in einigen Regionen wie us-central1 länger als erwartet dauern. Wenn die Bereitstellungslatenz in einer bestimmten Region ein Problem darstellt, empfiehlt Google, die Bereitstellung in einer anderen Region vorzunehmen.
• Das CDN von App Hosting kann nur eine bestimmte Gruppe von Anfrageheadern in seine Cache-Schlüssel aufnehmen. Diese Liste enthält die NextJS-Header RSC, Next-Router-State-Tree, Next-Router-Prefetch, Next-Router-Segment-Prefetch und Next-Url sowie die Cloud CDN-Standardheader 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 und X-Origin. Wenn eine Antwort einen Vary-Header mit einem hier nicht aufgeführten Wert enthält, wird sie von unserem CDN nicht im Cache gespeichert.
• Nicht im Cache gespeicherte statische Dateien werden aus Cloud Run bereitgestellt. In einer späteren Version werden sie zur Leistungsverbesserung im App Hosting-Ursprung gespeichert und von dort bereitgestellt.
• In der Firebase-Konsole wird bei der Back-End-Erstellung möglicherweise zeitweise der Fehler „Build wurde nicht gefunden und ist ungültig“ angezeigt.
• Alle Back-Ends im selben Projekt nutzen dieselbe GitHub-Organisation bzw. dasselbe GitHub-Konto. Sie können mit verschiedenen Repositorys unter dieser Organisation/diesem Konto verbunden werden. Wenn Sie Back-Ends erstellen möchten, die mit verschiedenen GitHub-Konten verbunden sind, müssen Sie sie in separaten Projekten platzieren.

Einschränkungen und Fehlerbehebung bei Angular-Apps

Die App Hosting-Unterstützung für Angular wird zwar aktiv weiterentwickelt und ausgebaut, unterliegt aber den folgenden Einschränkungen:

• I18n: Die grundlegenden I18n-Funktionen funktionieren, die direkte Navigation zu SSR-Seiten kann jedoch zu Fehlern führen.
• Lokalisierung: Das Erstellen von Versionen für verschiedene Sprachen wird nicht unterstützt.
• Builders: Derzeit wird nur der Application Builder unterstützt.
• Umgebungen und Monorepo-Tools: Angular-Projekte mit mehr als einem Anwendungsziel schlagen fehl. Wenn Sie eine umfassendere Unterstützung für Monorepos benötigen, verwenden Sie Nx.

Next.js-Einschränkungen und Fehlerbehebung

• Standardmäßig ist die integrierte NextJS-Bildoptimierung für App-Hosting deaktiviert, sofern Sie images.unoptimized nicht explizit auf „false“ setzen oder einen benutzerdefinierten Image Loader verwenden. Weitere Informationen zum Optimieren des Bildladens in Next.js
• URL-Pfade, die als Prozentwert codierte Zeichen enthalten, werden von Cloud Run decodiert. Dies kann zu Problemen mit Funktionen führen, die nur codierte URL-Pfade erwarten, z. B. das parallele Routing von Next.js.
• Derzeit beschränkt App Hosting das Caching für NextJS-Apps mit Middleware. Mit der Zeit sollten sich die Cache-Trefferquoten verbessern.
• URL-Pfade, die prozentcodierte Zeichen enthalten, werden von Cloud Run decodiert. Dies kann zu Problemen mit Funktionen führen, die nur codierte URL-Pfade erwarten, z. B. paralleles Routing in Next.js.