Kategoria: Next.js, React i TypeScript

Next.js opengraph-image generuje 500 podczas udostępniania linku

Poradnik techniczny · Kacper Bernecki

Strona otwiera się normalnie, ale endpoint /opengraph-image zwraca 500 i miniatura w komunikatorze nie działa. Generowanie grafiki OG ma osobne ograniczenia środowiska oraz fontów i może wykonywać inne instrukcje niż główna strona.

Jak rozpoznać źródło problemu

Prześledź log błędu samej trasy grafiki i sprawdź, czy żądanie nie dotyczy odmiennego runtime. Zweryfikuj rozmiar obrazu, obsługiwane formaty i czy wykorzystywana czcionka jest dostępna w pakiecie wdrożeniowym.

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

Kroki naprawcze

Uprość renderer i przekaż poprawne fonty lub zasoby wspierane przez ImageResponse, bez odwołań do niedostępnego filesystem. Przetestuj obraz bezpośrednio pod jego URL, niezależnie od renderowania strony i metatagów Open Graph.

Jak przetestować rozwiązanie

Obraz zwraca 200 z poprawnym typem media, a podgląd linku wyświetla aktualną grafikę.

Bezpieczeństwo i ograniczenia

Nie zakładaj, że poprawne og:image w HTML oznacza działający endpoint samej miniatury.