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.