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.