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.