Next.js Image: hostname is not configured under images — naprawa
Poradnik techniczny · Kacper Bernecki
Komponent next/image może odmówić wyświetlenia grafiki z zewnętrznej domeny, jeśli źródło nie pasuje do dozwolonych wzorców. To osobny problem od przycięcia zdjęcia przez CSS albo niedostępnego pliku.
Jak rozpoznać przyczynę
W konsoli przeglądarki lub logach Next.js odczytaj dokładny hostname i URL problematycznej grafiki. Porównaj je z images.remotePatterns w next.config.ts lub next.config.js. Zwróć uwagę na protokół, ścieżkę i parametry zapytania.
Sprawdź, czy oryginalny obraz otwiera się bezpośrednio. Jeżeli serwer zdjęć odpowiada 403 lub wymaga ciasteczka, samo dodanie remotePatterns nie naprawi autoryzacji zewnętrznego źródła.
Rozwiązanie krok po kroku
1. W next.config.ts dodaj wpis images.remotePatterns dla konkretnej, zaufanej domeny i odpowiedniej ścieżki plików. Nie dopuszczaj dowolnego hosta za pomocą zbyt szerokiego wildcarda.
2. Upewnij się, że hostname w konfiguracji odpowiada dokładnie domenie z src — włącznie z subdomeną. Sprawdź osobno https i ewentualny numer portu w środowisku testowym.
3. Jeśli obraz ma parametry URL, sprawdź dopasowanie właściwości search we wzorcu. Pusta wartość może wykluczać wszystkie adresy z query string.
4. Po zapisaniu konfiguracji uruchom ponownie serwer developerski lub wykonaj nowe wdrożenie. Zmiana next.config nie musi od razu obowiązywać w już uruchomionym procesie.
5. Jeżeli komunikat nadal występuje, sprawdź odpowiedź endpointu /_next/image i kod HTTP. Odróżnij 400 spowodowane dopasowaniem wzorca od błędu serwera źródłowego.
Jak sprawdzić, czy problem zniknął
Grafika powinna ładować się po twardym odświeżeniu strony, a Network nie powinien pokazywać odpowiedzi 400 dla /_next/image z powodu niezaufanego hosta.
Sprawdź również inną zewnętrzną domenę, która nie jest zaufana: nie powinna przypadkowo uzyskać dostępu do optymalizatora obrazów.
Czego nie robić
Nie przepisuj automatycznie każdego URL z błędu do szerokiej listy wildcardów. remotePatterns pełni funkcję kontroli dozwolonych źródeł.