UnboundLocalError: cannot access local variable 'r' where it is not associated with a value
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ă
for i in range(3):
try:
r = client.messages.create(...)
break
except anthropic.InternalServerError:
time.sleep(2 ** i)
return r.content[0].textfor 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
try:
r = client.messages.create(...)
except anthropic.APIError:
pass
print(r.content[0].text)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ă 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.
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?"))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.
Reparația
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}])
return r.content[0].text
except anthropic.InternalServerError:
time.sleep(2 ** i)
return "Asistentul e ocupat acum. Încearcă din nou în câteva minute."
print(intreaba("Aveți mese libere diseară?"))
print(intreaba("Aveți meniu pentru copii?"))De ce merge
Când toate încercările eșuează, linia r = client.messages.create(...) nu se termină niciodată, deci r nu are valoare. Cu return direct din try, ieși din funcție imediat ce ai un răspuns. Dacă ajungi după buclă, știi sigur că toate încercările au eșuat și întorci un mesaj clar. A doua întrebare reușește, pentru că API-ul și-a revenit.
Alte forme ale mesajului
UnboundLocalError: local variable 'r' referenced before assignmentNameError: 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
anthropic.InternalServerError: Error code: 529 - {'type': 'error', 'error': {'type': 'overloaded_error', 'message': 'Overloaded'}} Serverele Anthropic sunt temporar suprasolicitate; nu e vina codului sau a contului tău. Reîncearcă după o pauză (SDK-ul o face automat de 2 ori), iar pentru aplicațiile importante pregătește un plan B: alt model sau alt furnizor, plus un mesaj prietenos pentru utilizator. anthropic.APIConnectionError: Connection error. Cererea nu a ajuns la server sau răspunsul nu a ajuns înapoi: problemă de rețea, DNS, proxy, firewall sau o întrerupere scurtă. Verifică conexiunea și setările de proxy, lasă SDK-ul să reîncerce (`max_retries`) și prinde `APIConnectionError` cu un mesaj prietenos. NameError: name 'RateLimitError' is not defined Ai scris except RateLimitError:, dar numele nu e importat: excepțiile SDK-ului stau în modul. Scrie except anthropic.RateLimitError: (sau openai.RateLimitError), ori importă explicit: from anthropic import RateLimitError. Î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.
