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ę tworzenia i wdrażania aplikacji Next.js i Angular, w przypadku których zobowiązaliśmy się do zrozumienia tych platform i interpretowania ich natywnych konfiguracji. W przypadku wielu innych platform społeczność deweloperów obsługuje App Hosting adaptery platform. Dodatkowo w przypadku każdej aplikacji Node.js ze skryptem tworzenia i uruchamiania App Hosting podejmie próbę utworzenia, ale nie może zagwarantować sukcesu. Więcej informacji znajdziesz w artykule Integracja platform.

W których regionach usługa Firebase App Hosting jest dostępna?

Regiony, w których dostępne są usługi App Hosting, prawdopodobnie będą się z czasem rozszerzać. Najnowsze informacje znajdziesz w sekcji App Hosting lokalizacje.

Czy mogę używać GitLab lub innych dostawców Git oprócz GitHub do wdrażania?

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 spróbuj wybrać 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 na GitHubie 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 roku, mogą stwierdzić, że witryna nie wyświetla się prawidłowo w Android WebView. 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 App Hostingbackendu i dodaj ją ponownie. Zaktualizowany interfejs konsoli udostępni 3 nowe rekordy: rekord A i rekord 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?

Obecnie nie można zmienić repozytorium. Możesz jednak utworzyć nowy backend powiązany z preferowanym repozytorium w tym samym projekcie lub utworzyć nowy backend w osobnym projekcie.

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ć jej 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-oath 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 GitHubem.

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

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

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

• Z powodu problemu z infrastrukturą Cloud Run tworzenie lub aktualizowanie zasobów może być wolniejsze niż oczekiwano w niektórych regionach, np. us-central1. Jeśli opóźnienie wdrażania jest problemem w danym regionie, Google zaleca wdrożenie w innym regionie.
• Sieć CDN App Hosting może uwzględniać w kluczach pamięci podręcznej tylko określony zestaw nagłówków żądań. Ta lista 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ą przechowywane i dostarczane z App Hosting, co zwiększy wydajność.
• Konsola Firebase może okresowo wyświetlać błąd „build was not found and is invalid” (nie znaleziono kompilacji, która jest 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 dla Angulara jest aktywnie rozwijany i ulepszana, ma te 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 nagłówków zaufanego serwera proxy w dokumentacji Angulara).
• Angular w wersji 22: pierwsza kompilacja w nowym backendzie może zwracać błędy 400. Aby rozwiązać ten problem, wygeneruj drugą kompilację. Wszystkie kolejne kompilacje powinny działać prawidłowo.

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.Więcej informacji znajdziesz w artykule Optymalizowanie wczytywania obrazów w Next.js.
• Ścieżki URL zawierające znaki zakodowane za pomocą procentów 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 Next.js.
• Obecnie App Hosting ogranicza buforowanie aplikacji NextJS przy użyciu middleware. Z czasem współczynnik trafień w pamięci podręcznej powinien się zwiększać.
• Ścieżki adresów URL zawierające znaki zakodowane za pomocą procentów są dekodowane przez Cloud Run. Może to powodować problemy z funkcjami, które oczekują tylko zakodowanych ścieżek adresów URL, np. z równoległym routingiem w Next.js.