Kategoria: Next.js, React i TypeScript

Next.js next/font: Failed to fetch Google Fonts podczas builda

Poradnik techniczny · Kacper Bernecki

Wdrożenie przerywa kompilację przy pobieraniu czcionki przez next/font/google. Proces budowania może nie mieć dostępu do serwera czcionek, a automatyczny fetch nie jest niezawodny w każdym środowisku.

Jak rozpoznać źródło problemu

Sprawdź konkretny font, jego wagę i logi błędu sieciowego z procesu build. Porównaj, czy projekt przechodzi build w środowisku z dostępem sieciowym i bez niego.

Porównaj komunikat z konsoli z wynikiem kompilacji produkcyjnej oraz stanem po odświeżeniu strony.

Kroki naprawcze

Zweryfikuj konfigurację czcionki i w razie potrzeby użyj legalnie uzyskanych plików lokalnych przez next/font/local. Upewnij się, że wybrane wagi i subsety rzeczywiście istnieją i nie generują niepotrzebnych requestów.

Jak przetestować rozwiązanie

Build przechodzi bez niekontrolowanego pobierania zasobów w runtime i tekst jest czytelny przy fallbacku.

Bezpieczeństwo i ograniczenia

Nie pobieraj przypadkowych fontów z nieznanych stron ani nie łam ich licencji.