Najczęstsze pytania i rozwiązywanie problemów

Na tej stronie znajdziesz odpowiedzi na najczęstsze pytania dotyczące App Hosting.

App Hosting Najczęstsze pytania

Czy App Hosting obsługuje platformy inne niż Next.js i Angular?

App Hosting zapewnia wstępnie skonfigurowaną obsługę kompilacji i wdrażania w przypadku Next.js i Angulara, w których przypadku zobowiązaliśmy się do zrozumienia tych platform i interpretowania ich natywnych konfiguracji; W przypadku wielu innych platform społeczność programistów obsługuje App Hosting adaptery platform. Dodatkowo w przypadku każdej aplikacji Node.js ze skryptem kompilacji i uruchamiania App Hosting będzie próbować przeprowadzić kompilację, ale nie może zagwarantować, że się to uda. Zobacz Integracja z platformą.

W jakich regionach usługa Firebase App Hosting jest dostępna?

Regiony, w których dostępna jest usługa App Hosting, prawdopodobnie będą się z czasem rozszerzać. Najnowsze informacje znajdziesz w sekcji App Hostinglokalizacje.

Czy do wdrażania mogę używać GitLaba lub innych dostawców Git poza GitHubem?

Obecnie nie jest to możliwe, ale obsługa innych dostawców jest w długoterminowym planie rozwoju App Hosting.

Dlaczego nie mogę znaleźć repozytorium w interfejsie konsoli Firebase?

Jeśli repozytorium nie pojawia się na liście opcji podczas tworzenia nowego backendu w Firebase konsoli, najpierw kliknij Odśwież listę. Jeśli preferowane repozytorium nadal nie jest dostępne, może być konieczne dodanie go za pomocą opcji Przyznaj dostęp do nowego repozytorium w GitHubie.

Repozytoriami możesz też zarządzać za pomocą aplikacji Firebase App HostingGitHub. Aby to zrobić, otwórz profil GitHub i wybierz Ustawienia, a potem Aplikacje. W wierszu tabeli aplikacji Firebase App Hosting kliknij Skonfiguruj, aby zarządzać repozytoriami.

Dlaczego moja witryna nie wyświetla się prawidłowo w komponencie WebView aplikacji mobilnej na Androida?

Aplikacje, w których skonfigurowano domenę niestandardową za pomocą Firebase konsoli przed III kwartałem 2025 r., mogą stwierdzić, że witryna nie wyświetla się prawidłowo w widoku WebView na Androidzie. Dzieje się tak, ponieważ rekordy CNAME używane w tym okresie nie były zgodne z komponentem WebView na Androidzie.

Aby rozwiązać ten problem, usuń domenę niestandardową z backendu App Hosting i dodaj ją ponownie. Zaktualizowany interfejs konsoli udostępni 3 nowe rekordy: rekord A i TXT dla domeny oraz rekord CNAME dla subdomeny testu ACME (w przypadku certyfikatów). Użyj tych rekordów zamiast poprzedniego rekordu CNAME.

Jak zmienić repozytorium powiązane z projektem App Hosting?

W konsoli Firebase otwórz App Hosting backend i wybierz Ustawienia > Wdrożenie. W sekcji Repozytorium GitHub możesz odłączyć bieżące repozytorium lub wybrać inne repozytorium połączone z Twoim projektem.

Jak mogę ustawić nagłówki w witrynie App Hosting?

Nagłówki zależą od platformy. Wykonaj wszystkie czynności, które zwykle wykonujesz w przypadku swojego frameworka.

Czy istnieje emulator do lokalnego programowania z App Hosting?

Tak, przed wdrożeniem aplikacji możesz przeprowadzić testy lokalne za pomocą App HostingemulatoraApp Hosting, który jest częścią Pakietu emulatorów lokalnych Firebase. Zobacz Lokalne testowanie wdrożenia aplikacji .

Dlaczego widzę błędy w App Hosting, ale nie w Cloud Build?

W takich przypadkach błąd może pochodzić z Cloud Run. Aby się upewnić, sprawdź stan wdrożenia.

Jak zmienić lub usunąć połączone konto GitHub?

Aby usunąć połączone konto GitHub, otwórz Developer Connect, upewnij się, że wybrany jest Twój projekt, i usuń połączenie firebase-app-hosting-github-oauth oraz połączenie zaczynające się od apphosting-github-conn-. Gdy otworzysz App Hosting w konsoli Firebase, powinna pojawić się możliwość skonfigurowania nowego połączenia z GitHub.

Jak mogę ustawić pliki cookie w witrynie App Hosting?

Chociaż nie był dostępny w momencie wprowadzenia App Hostingwersji podglądowej, Set-Cookienagłówek odpowiedzi HTTP działa teraz zgodnie z oczekiwaniami.

Ogólne ograniczenia i rozwiązywanie problemów z App Hosting

• Z powodu problemu z infrastrukturą Cloud Run tworzenie lub aktualizowanie zasobów może być wolniejsze niż oczekiwano w niektórych regionach, np. w us-central1. Jeśli w danym regionie występuje problem z opóźnieniem wdrożenia, Google zaleca wdrożenie w innym regionie.
• Sieć CDN usługi App Hosting może uwzględniać w kluczach pamięci podręcznej tylko określony zestaw nagłówków żądań. Lista ta obejmuje nagłówki NextJS: RSC, Next-Router-State-Tree,Next-Router-Prefetch, Next-Router-Segment-Prefetch i Next-Url, a także standardowe nagłówki 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 i X-Origin. Jeśli odpowiedź zawiera nagłówek Vary z wartością, której nie ma na tej liście, nasza sieć CDN nie będzie jej buforować.
• Niebuforowane pliki statyczne są dostarczane z Cloud Run. W późniejszej wersji będą one przechowywane i dostarczane z App Hosting, co zwiększy wydajność.
• Konsola Firebase może okresowo wyświetlać błąd „nie znaleziono kompilacji i jest ona nieprawidłowa” podczas tworzenia backendu.
• Wszystkie back-endy w tym samym projekcie współdzielą organizację lub konto GitHub. Mogą być połączone z różnymi repozytoriami w ramach tej organizacji lub tego konta. Aby utworzyć back-endy połączone z różnymi kontami GitHub, umieść je w osobnych projektach.

Ograniczenia aplikacji Angular i rozwiązywanie problemów

Chociaż App Hosting jest aktywnie rozwijany i wsparcie dla Angulara jest coraz większe, ma on następujące ograniczenia:

• I18n: podstawowe funkcje I18n działają, ale bezpośrednie przechodzenie do stron SSR może powodować błędy.
• Lokalizacja: tworzenie wersji dla różnych regionów nie jest obsługiwane.
• Kreatory: obecnie obsługiwany jest tylko kreator aplikacji.
• Środowiska i narzędzia Monorepo: projekty Angulara, które mają więcej niż 1 aplikację docelową, nie będą działać. Aby uzyskać pełniejsze wsparcie dla monorepo, użyj Nx.

Błędy HTTP 400 i zaufanie serwera proxy w Angular SSR

Jeśli aplikacja Angular wdrożona w Firebase App Hosting napotyka błędy HTTP 400 (Nieprawidłowe żądanie), blokery weryfikacji hosta lub błędy zaufania serwera proxy, zastosuj zalecane rozwiązanie dla swojej wersji Angulara:

• Angular w wersjach 19, 20 i 21: te błędy HTTP 400 możesz rozwiązać na 2 sposoby:
  • Uaktualnij zależności: uruchom npm update @angular/core @angular/ssr, aby zainstalować najnowszą wersję poprawki dla bieżącej wersji Angulara.
  • Konfiguracja ręczna: zastosuj rezerwowe ustawienia konfiguracji na poziomie kodu, ustawiając trustProxyHeaders: true w konfiguracji serwera (więcej informacji znajdziesz w sekcji Konfigurowanie zaufanych nagłówków serwera proxy w dokumentacji Angulara).
• Angular w wersji 22: pierwsza kompilacja na nowym backendzie może zwracać błędy 400. Aby rozwiązać ten problem, wygeneruj drugą kompilację. Wszystkie kolejne kompilacje powinny działać zgodnie z oczekiwaniami.

Ograniczenia Next.js i rozwiązywanie problemów

• Domyślnie wbudowana optymalizacja obrazów NextJS jest wyłączona w usłudze App Hosting, chyba że jawnie ustawisz wartość images.unoptimized na false lub użyjesz niestandardowego modułu wczytującego obrazy. Zobacz Optymalizacja ładowania obrazów w Next.js.
• Obecnie App Hosting ogranicza buforowanie aplikacji NextJS korzystających z oprogramowania pośredniczącego. Z czasem współczynnik trafień w pamięci podręcznej powinien się zwiększać.
• Ścieżki URL zawierające znaki zakodowane za pomocą znaku procenta są dekodowane przez Cloud Run. Może to powodować problemy z funkcjami, które oczekują tylko zakodowanych ścieżek URL, np. z równoległym routingiem w Next.js.