...
Eroare PostgreSQL · Funcții, proceduri și triggere PL/pgSQL

ERROR: control reached end of function without RETURN

Pe scurt

Funcția PL/pgSQL declară un tip întors, dar execuția a ajuns la END fără să întâlnească un RETURN, de obicei pe o ramură IF uitată (lipsește ELSE). Asigură-te că fiecare drum prin funcție se termină cu RETURN valoare.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

O funcție PL/pgSQL care întoarce o valoare (orice tip în afară de void, trigger sau SETOF) trebuie să execute un RETURN pe fiecare drum posibil. Dacă un IF ... ELSIF nu acoperă toate cazurile, sau un RETURN e doar într-o buclă, execuția poate ajunge la END fără valoare, iar funcția dă această eroare la apel, numai pentru datele care urmează acel drum.

PostgreSQL nu verifică asta la creare, deci funcția poate merge luni întregi și să cadă pentru un caz rar (de exemplu un client fără comenzi). Remedii: un ELSE final în orice IF din care se întoarce valoarea, un RETURN la sfârșitul funcției ca plasă de siguranță, sau o funcție scrisă ca o singură expresie CASE în LANGUAGE sql. Pentru funcțiile RETURNS SETOF, finalul fără RETURN e permis; acolo rezultatul se construiește cu RETURN NEXT și RETURN QUERY.

De ce apare: cauzele frecvente

1IF fără ELSE

Greșit
SQL
IF v_total > 1000 THEN RETURN 'gold';
ELSIF v_total > 100 THEN RETURN 'silver';
END IF;
END
Corect
SQL
IF v_total > 1000 THEN RETURN 'gold';
ELSIF v_total > 100 THEN RETURN 'silver';
ELSE RETURN 'standard';
END IF;
END

Ramura ELSE acoperă toate cazurile rămase.

2Valoare NULL care ocolește toate condițiile

Greșit
SQL
IF v_total > 1000 THEN ... ELSIF v_total <= 1000 THEN ... END IF;  -- v_total NULL
Corect
SQL
IF coalesce(v_total, 0) > 1000 THEN ... ELSE ... END IF;

Comparațiile cu NULL nu sunt nici adevărate, nici false, deci niciun IF nu se execută.

Repară tu

Repară eroarea, direct în pagină

Funcția nivel_client clasifică clienții după totalul cumpărăturilor, dar pentru Elena Dinu, care nu are comenzi, dă control reached end of function without RETURN. Adaugă o ramură ELSE care întoarce „standard” și afișează numele și nivelul tuturor clienților.

Codul care dă eroarea
SQL
CREATE FUNCTION nivel_client(p_id int) RETURNS text LANGUAGE plpgsql AS $$
DECLARE
  v numeric;
BEGIN
  SELECT sum(total) INTO v FROM comenzi WHERE client_id = p_id;
  IF v > 2000 THEN
    RETURN 'gold';
  ELSIF v > 500 THEN
    RETURN 'silver';
  END IF;
END $$;
SELECT nume, nivel_client(id) FROM clienti ORDER BY id;
După reparație, programul afișează
CREATE FUNCTION
     nume      | nivel_client
---------------+--------------
 Ana Pop       | gold
 Mihai Ionescu | silver
 Elena Dinu    | standard
(3 rânduri)
Indiciu

ELSE RETURN 'standard';

Cum o eviți pe viitor

  • Încheie orice lanț IF ... ELSIF din care întorci valori cu un ELSE.
  • Tratează explicit valorile NULL (clienți fără comenzi, coloane lipsă).
  • Testează funcțiile pe cazurile limită: zero rânduri, NULL, valori la granițele condițiilor.
  • Pentru clasificări simple, folosește o expresie CASE într-o funcție LANGUAGE sql.

Întrebări frecvente

De ce cade doar pentru unii clienți?

Pentru că doar datele lor duc pe drumul fără RETURN, de exemplu un total NULL pentru clienții fără comenzi.

Funcțiile void au nevoie de RETURN?

Nu. Pot ajunge la END fără RETURN.

Erori înrudite

← Toate erorile PostgreSQL

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață PostgreSQL de la zero, cu exerciții la fiecare lecție

Curs PostgreSQL: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.