Kategoria: Vercel i hosting

Vercel Function timed out przy wolnym zewnętrznym API

Poradnik techniczny · Kacper Bernecki

Funkcja serwerowa zwraca timeout, gdy czeka na odpowiedź dostawcy zamiast wykonać logikę biznesową. Czas oczekiwania na zewnętrzne żądanie może zużyć cały budżet wykonania funkcji.

Jak ustalić źródło błędu

Z logów odczytaj czas trwania requestu i ustal, która integracja odpowiada najwolniej.

Sprawdź, czy timeout dotyczy funkcji Vercel, fetch do dostawcy czy połączenia z bazą.

Co zrobić krok po kroku

1. Dodaj własny AbortSignal.timeout dla wywołań zewnętrznych i jasno obsłuż przekroczenie limitu.

2. Dłuższe zadania oddziel od krótkiej odpowiedzi HTTP przez kolejkowanie i mechanizm retry, jeśli proces na to pozwala.

Jak sprawdzić wynik

Przekroczenie czasu zewnętrznego API daje kontrolowany błąd, a zwykłe żądania nie przekraczają limitu.

Czego nie robić

Nie wydłużaj bez końca jednego żądania klienta, jeśli operacja powinna działać asynchronicznie.