Kategoria: Next.js, React i TypeScript

Next.js Route Handler GET zwraca stary JSON po aktualizacji

Poradnik techniczny · Kacper Bernecki

Po zmianie konfiguracji endpoint /api/config pokazuje poprzednie wartości, chociaż baza ma nowe dane. Cache i sposób renderowania route handlerów zależą od wersji Next.js oraz jawnych ustawień revalidate lub fetch.

Jak rozpoznać źródło problemu

Sprawdź wersję frameworka i odpowiedź endpointu w Network z odpowiednimi nagłówkami cache. Porównaj odczyt danych bezpośrednio w bazie i wynik tego samego requestu bez CDN lub cache przeglądarki.

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

Kroki naprawcze

Dla danych wymagających świeżości skonfiguruj odpowiednie cache-control lub dynamic behavior i jawnie oznacz operację jako dynamiczną. Dla danych, które mogą być buforowane, ustaw przewidywalny czas odświeżania i kontrolowane unieważnianie cache.

Jak przetestować rozwiązanie

Po zmianie rekordu API zwraca nową wartość w wymaganym czasie, a niezbędne cache pozostaje skuteczne.

Bezpieczeństwo i ograniczenia

Nie kopiuj konfiguracji cache między różnymi wersjami Next.js bez sprawdzenia jej znaczenia.