...
Eroare Python · Excepții, aserțiuni și generatoare

RuntimeError: generator raised StopIteration

Pe scurt

În interiorul unui generator (o funcție cu `yield`) ai apelat `next()` pe un iterator terminat, iar `StopIteration` a ieșit din generator. Prinde-o și încheie generatorul cu `return`, sau dă lui `next` o valoare implicită: `next(it, None)`.

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

Ce înseamnă

StopIteration e semnalul intern prin care un iterator spune „nu mai am elemente”. for, list() și alte construcții îl prind automat. În interiorul unui generator, însă, o StopIteration scăpată (de obicei dintr-un next(it) pe un iterator epuizat) ar fi oprit generatorul pe tăcute, ascunzând bug-uri. De aceea, din Python 3.7 (PEP 479), o astfel de StopIteration e transformată în RuntimeError: generator raised StopIteration.

Mesajul complet îți arată două excepții: StopIteration (cauza, la linia cu next) și RuntimeError (la nivelul generatorului). Reparația corectă e să tratezi explicit sfârșitul iteratorului: prinzi StopIteration și faci return, care încheie generatorul normal, sau folosești next(it, implicit) și verifici valoarea. Cazul tipic: grupezi elemente câte două sau citești o pereche antet-valoare dintr-un flux.

De ce apare: cauzele frecvente

1next fără protecție în generator

Greșit
PYTHON
def perechi(elemente):
    it = iter(elemente)
    while True:
        yield (next(it), next(it))
print(list(perechi([1, 2, 3, 4])))
Corect
PYTHON
def perechi(elemente):
    it = iter(elemente)
    while True:
        try:
            yield (next(it), next(it))
        except StopIteration:
            return
print(list(perechi([1, 2, 3, 4])))

return încheie generatorul normal când iteratorul se termină.

2Primul element dintr-o listă goală

Greșit
PYTHON
def cu_antet(linii):
    it = iter(linii)
    antet = next(it)
    for linie in it:
        yield antet, linie
print(list(cu_antet([])))
Corect
PYTHON
def cu_antet(linii):
    it = iter(linii)
    antet = next(it, None)
    if antet is None:
        return
    for linie in it:
        yield antet, linie
print(list(cu_antet([])))

next(it, None) întoarce None în loc să ridice excepția, iar generatorul se încheie curat.

Repară tu

Repară eroarea, direct în pagină

Generatorul de mai jos grupează elementele unei liste câte două, dar la final dă RuntimeError: generator raised StopIteration. Tratează sfârșitul iteratorului în generator, ca programul să afișeze [(1, 2), (3, 4)].

Codul care dă eroarea
PYTHON
def perechi(elemente):
    it = iter(elemente)
    while True:
        a = next(it)
        b = next(it)
        yield (a, b)

print(list(perechi([1, 2, 3, 4])))
După reparație, programul afișează
[(1, 2), (3, 4)]
Indiciu

Prinde StopIteration în generator și încheie-l cu return.

Alte forme ale mesajului

  • StopIteration

Cum o eviți pe viitor

  • În generatoare, nu lăsa next() neprotejat: folosește next(it, implicit) sau prinde StopIteration.
  • Încheie generatoarele cu return, nu cu raise StopIteration.
  • Pentru grupări, există unelte gata făcute: itertools.batched(elemente, 2) (Python 3.12+) sau zip(it, it).
  • Testează generatoarele și pe liste goale sau cu număr impar de elemente.

Întrebări frecvente

De ce Python nu lasă StopIteration să oprească generatorul?

Pentru că ar ascunde greșeli: un next greșit adânc în cod ar opri iterarea fără niciun semn, iar rezultatul ar fi pur și simplu incomplet. RuntimeError face problema vizibilă.

Care e diferența față de StopIteration simplu?

StopIteration simplu apare când apelezi next() în afara unui generator, pe un iterator terminat. Aici excepția a apărut în interiorul unui generator și Python a transformat-o.

Erori înrudite

← Toate erorile Python

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ță Python de la zero, cu exerciții la fiecare lecție

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