Kategoria: Next.js, React i TypeScript

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