...
Eroare Aplicații AI cu LLM · Rate limit, suprasolicitare, timeout și retry

UnboundLocalError: cannot access local variable 'r' where it is not associated with a value

Pe scurt

Toate încercările din bucla de retry au eșuat, deci variabila cu răspunsul nu a primit niciodată valoare, iar return r o folosește oricum. Întoarce răspunsul din interiorul try și, după buclă, tratează explicit cazul în care nicio încercare n-a reușit.

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

Ce înseamnă

Variabila r primește valoare doar dacă client.messages.create(...) reușește. Când fiecare încercare ridică o excepție prinsă de except, bucla se termină fără ca linia de atribuire să fi rulat vreodată. Apoi return r.content[0].text încearcă să citească o variabilă locală fără valoare, iar Python ridică UnboundLocalError (în Python 3.10 și mai vechi: local variable 'r' referenced before assignment).

E o eroare tipică pentru codul de retry: la testare totul merge, iar în ziua în care API-ul e suprasolicitat câteva minute (529) sau rețeaua cade, apare eroarea asta în locul unui mesaj clar. Problema reală e că lipsește decizia: ce face aplicația când API-ul nu răspunde deloc?

De ce apare: cauzele frecvente

1Răspunsul folosit după buclă

Greșit
PYTHON
for i in range(3):
    try:
        r = client.messages.create(...)
        break
    except anthropic.InternalServerError:
        time.sleep(2 ** i)
return r.content[0].text
Corect
PYTHON
for i in range(3):
    try:
        r = client.messages.create(...)
        return r.content[0].text
    except anthropic.InternalServerError:
        time.sleep(2 ** i)
return "Asistentul e ocupat acum. Încearcă din nou în câteva minute."

Răspunsul se întoarce din try, iar după buclă ajungi doar dacă toate încercările au eșuat.

2Eroarea înghițită cu pass

Greșit
PYTHON
try:
    r = client.messages.create(...)
except anthropic.APIError:
    pass
print(r.content[0].text)
Corect
PYTHON
try:
    r = client.messages.create(...)
except anthropic.APIError as e:
    print("Eroare API:", e)
else:
    print(r.content[0].text)

else rulează doar când try a reușit, deci r există sigur.

Repară tu

Repară eroarea, direct în pagină

Funcția intreaba reîncearcă de 3 ori când API-ul e suprasolicitat (529). Când toate cele 3 încercări eșuează, cade cu UnboundLocalError: cannot access local variable 'r'.... Repar-o: întoarce textul din try și, după buclă, întoarce mesajul Asistentul e ocupat acum. Încearcă din nou în câteva minute.

Codul care dă eroarea
PYTHON
import time

import anthropic

MODEL = "claude-haiku-5-5"
client = anthropic.Anthropic(max_retries=0)


def intreaba(text, incercari=3):
    for i in range(incercari):
        try:
            r = client.messages.create(model=MODEL, max_tokens=100, messages=[{"role": "user", "content": text}])
            break
        except anthropic.InternalServerError:
            time.sleep(2 ** i)
    return r.content[0].text


print(intreaba("Aveți mese libere diseară?"))
print(intreaba("Aveți meniu pentru copii?"))
După reparație, programul afișează
Asistentul e ocupat acum. Încearcă din nou în câteva minute.
Da, avem un meniu pentru copii, cu porții mai mici.
Indiciu

Mută return r.content[0].text în try, în locul lui break.

Alte forme ale mesajului

  • UnboundLocalError: local variable 'r' referenced before assignment
  • NameError: name 'r' is not defined

Cum o eviți pe viitor

  • În codul de retry, întoarce rezultatul din interiorul try.
  • După buclă, decide explicit: un mesaj prietenos, alt furnizor sau re-ridicarea excepției cu raise.
  • Nu folosi except: pass: ascunde problema și o mută câteva linii mai jos.
  • Testează cazul în care toate încercările eșuează, cu erori simulate.

Întrebări frecvente

De ce în afara unei funcții apare NameError, nu UnboundLocalError?

La nivelul modulului nu există variabile locale: un nume fără valoare dă NameError: name 'r' is not defined. Cauza și reparația sunt aceleași.

E bine să întorc un mesaj în loc de eroare?

Pentru un chatbot, da: utilizatorul vede un mesaj clar, iar tu scrii eroarea în log. Într-un job automat e mai bine să ridici excepția, ca jobul să fie marcat eșuat și reluat.

Erori înrudite

← Toate erorile Aplicații AI cu LLM

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

Curs Aplicații AI cu Claude și OpenAI: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 8 lecții sunt gratuite.