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 dla Next.js i Angulara, gdzie zobowiązaliśmy się do zrozumienia tych platform i interpretowania ich natywnych konfiguracji. W przypadku wielu innych platform społeczność deweloperów obsługuje adaptery platformy App Hosting. Dodatkowo w przypadku każdej aplikacji Node.js ze skryptem kompilacji i uruchamiania App Hosting spróbuje przeprowadzić kompilację, ale nie może zagwarantować, że się powiedzie. Zobacz Integracja platformy.

Które regiony obsługuje Firebase App Hosting?

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

Czy do wdrożeń mogę używać GitLaba lub innych dostawców Git oprócz GitHuba?

Obecnie nie jest to możliwe, ale obsługa innych dostawców jest w długoterminowych planach dotyczących App Hosting.

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

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

Dodatkowo możesz zarządzać repozytoriami za pomocą aplikacji Firebase App Hosting GitHub. Aby to zrobić, otwórz swój profil na GitHubie i wybierz Settings (Ustawienia), a następnie Applications (Aplikacje). W wierszu tabeli odpowiadającym aplikacji Firebase App Hosting kliknij Skonfiguruj, aby zarządzać repozytoriami.

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

Aplikacje, które skonfigurowały własną domenę za pomocą konsoli Firebase przed III kwartałem 2025 r., mogą nie wyświetlać się prawidłowo w komponencie 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ń własną domenę z backendu App Hosting i dodaj ją ponownie. Zaktualizowany interfejs konsoli zawiera 3 nowe rekordy: rekord A i rekord TXT dla domeny oraz rekord CNAME dla subdomeny wyzwania ACME dla 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 backend App Hosting i kliknij Ustawienia > Wdrażanie. W sekcji Repozytorium GitHub możesz odłączyć bieżące repozytorium lub wybrać inne repozytorium połączone z projektem.

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

Nagłówki zależą od platformy. Skonfiguruj nagłówki zgodnie z dokumentacją platformy.

Czy jest dostępny emulator do lokalnego programowania w App Hosting?

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

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

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 projekt jest wybrany, i usuń połączenie firebase-app-hosting-github-oauth oraz połączenie, które zaczyna się od apphosting-github-conn-. Gdy otworzysz App Hosting w konsoli Firebase, powinna być dostępna opcja skonfigurowania nowego połączenia z GitHubem.

Jak ustawić pliki cookie w witrynie App Hosting?

Chociaż nagłówek odpowiedzi HTTP Set-Cookie nie był dostępny w momencie wprowadzenia wersji testowej App Hosting, teraz działa 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, takich jak us-central1. Jeśli opóźnienie wdrożenia jest problemem w konkretnym regionie, Google zaleca wdrożenie w innym regionie.

• Sieć CDN dla usługi App Hosting może zawierać w kluczach pamięci podręcznej tylko określony zestaw nagłówków żądań. Lista zawiera:

  • Nagłówki Next.js: RSC, Next-Router-State-Tree, Next-Router-Prefetch, Next-Router-Segment-Prefetch i Next-Url.

  • 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.

  Pamiętaj, że jeśli odpowiedź zawiera nagłówek Vary z wartością, której nie ma na tej liście, sieć CDN nie zapisze jej w pamięci podręcznej.

• Niezbuforowane pliki statyczne są udostępniane z Cloud Run. W późniejszej wersji będą przechowywane i udostępniane z App Hosting, co zapewni lepszą wydajność.

• Podczas tworzenia backendu konsola Firebase może czasami wyświetlać błąd „Nie znaleziono kompilacji i jest ona nieprawidłowa”.

• Wszystkie backendy w tym samym projekcie współdzielą organizację/konto GitHub. Można je połączyć z różnymi repozytoriami w tej organizacji lub na tym koncie. Aby utworzyć backendy połączone z różnymi kontami GitHub, umieść je w osobnych projektach.

Ograniczenia aplikacji Angular i rozwiązywanie problemów

Chociaż obsługa Angulara w App Hosting jest aktywnie rozwijana i rozszerzana, ma ona te ograniczenia:

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

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

Jeśli w aplikacji Angular wdrożonej na platformie Firebase App Hosting występują błędy HTTP 400 (Nieprawidłowe żądanie), blokady weryfikacji hosta lub błędy zaufania serwera proxy, zastosuj zalecane rozwiązanie dla Twojej wersji Angular:

• 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ą poprawkę dla bieżącej wersji Angular.
  • Konfiguracja ręczna: zastosuj konfigurację zastępczą na poziomie kodu, ustawiając trustProxyHeaders: true w konfiguracji serwera (patrz Konfigurowanie nagłówków zaufanego serwera proxy w dokumentacji Angular).
• 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ć zgodnie z oczekiwaniami.

Ograniczenia Next.js i rozwiązywanie problemów

• Domyślnie wbudowana optymalizacja obrazów NextJS jest wyłączona w App Hosting, chyba że wyraźnie ustawisz images.unoptimized na wartość false lub użyjesz niestandardowego modułu ładowania obrazów. Zobacz Optymalizacja wczytywania obrazów w Next.js.
• Domyślnie Next.js zapisuje strony i dane z pamięci podręcznej w systemie plików, co wlicza się do pamięci każdej instancji wyświetlającej w App Hosting. Jeśli instancje uruchamiają się ponownie z błędami Memory limit exceeded, zapoznaj się z artykułem Konfigurowanie buforowania serwera w Next.js.
• Obecnie App Hosting ogranicza buforowanie aplikacji NextJS za pomocą oprogramowania pośredniczącego. Z czasem współczynniki trafień w pamięci podręcznej powinny się poprawić.
• Ś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 adresu URL, takimi jak routing równoległy Next.js.