Kategoria: Supabase i bazy danych

PostgreSQL: 57014 canceling statement due to statement timeout

Poradnik techniczny · Kacper Bernecki

Zapytanie do bazy zostaje przerwane kodem 57014, szczególnie przy większej tabeli. Baza przerwała wykonanie po przekroczeniu limitu czasu lub na żądanie anulowania.

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

Przejrzyj plan EXPLAIN ANALYZE w bezpiecznym środowisku i czas wykonania z filtrami produkcyjnymi.

Sprawdź indeksy kolumn używanych w WHERE, kolejność złączeń i czy aplikacja nie pobiera niepotrzebnie całej tabeli.

Co zrobić krok po kroku

1. Dodaj indeks pasujący do rzeczywistego predykatu lub zmniejsz zakres zapytania przez paginację i selekcję kolumn.

2. Rozważ zwiększenie timeoutu dopiero po pomiarze i wykluczeniu problemu wydajnościowego.

Jak sprawdzić wynik

Zapytanie wykonuje się w wymaganym czasie i zwraca taką samą poprawną liczbę rekordów.

Czego nie robić

Nie ustawiaj bezterminowego timeoutu dla każdego endpointu w odpowiedzi na pojedynczy wolny raport.