ValueError: Circular reference detected
Structura dată lui json.dumps se conține pe ea însăși: un bloc care ține referință la blocul anterior întreg, care ține la rândul lui referință înapoi, sau o listă adăugată în ea însăși. Serializează doar valorile (de ex. hash-ul anterior), nu obiectele legate între ele.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
json.dumps parcurge dicționarele și listele în adâncime. Dacă dă peste un obiect pe care îl serializează deja (un ciclu), s-ar învârti la nesfârșit, așa că se oprește cu Circular reference detected. Mesajul poate fi urmat de when serializing dict item 'anterior', care îți spune ce cheie a închis ciclul.
În blockchain ciclul apare când legi blocurile prin obiecte, nu prin hash-uri: bloc["anterior"] = lant[-1] și apoi blocul anterior primește o listă de „urmași”, sau lanțul ține blocurile, iar fiecare bloc ține lanțul. Pe lângă eroare, e și o greșeală de model: într-un blockchain, un bloc indică spre cel anterior prin hash, un text de 64 de caractere, nu prin obiectul întreg. Așa blocul poate fi serializat singur și trimis prin rețea. Caută cheia din mesaj și înlocuiește obiectul cu hash-ul lui.
De ce apare: cauzele frecvente
1Blocul ține obiectul anterior, nu hash-ul
geneza = {"index": 0, "urmasi": []}
b1 = {"index": 1, "anterior": geneza}
geneza["urmasi"].append(b1)
json.dumps(b1)geneza = {"index": 0, "hash": "00ab"}
b1 = {"index": 1, "hash_anterior": geneza["hash"]}
json.dumps(b1)Legătura prin hash e doar un text, deci nu se poate forma un ciclu.
2Lista adăugată în ea însăși
lant = []
lant.append(lant)
json.dumps(lant)lant = []
lant.append({"index": 0})
json.dumps(lant)lant.append(lant) pune lista în ea însăși; de obicei voiai să adaugi un bloc.
Repară eroarea, direct în pagină
Codul de mai jos construiește trei blocuri, fiecare legat de cel anterior prin obiectul întreg, iar la serializare dă ValueError: Circular reference detected. Repară legătura ca fiecare bloc să păstreze doar hash-ul blocului anterior, iar programul să afișeze JSON-ul ultimului bloc.
import hashlib, json
def h(b):
return hashlib.sha256(f"{b['index']}|{b['date']}".encode()).hexdigest()[:12]
lant = []
for i, date in enumerate(["geneza", "Ana->Bogdan:5", "Bogdan->Carmen:2"]):
bloc = {"index": i, "date": date, "urmasi": []}
if lant:
bloc["anterior"] = lant[-1]
lant[-1]["urmasi"].append(bloc)
bloc["hash"] = h(bloc)
lant.append(bloc)
print(json.dumps(lant[-1], sort_keys=True)){"date": "Bogdan->Carmen:2", "hash": "ddda89602b1e", "hash_anterior": "ed6be42622f1", "index": 2}Indiciu
Un bloc indică spre cel anterior printr-un text, nu prin obiect.
Reparația
import hashlib, json
def h(b):
return hashlib.sha256(f"{b['index']}|{b['date']}".encode()).hexdigest()[:12]
lant = []
for i, date in enumerate(["geneza", "Ana->Bogdan:5", "Bogdan->Carmen:2"]):
bloc = {"index": i, "date": date}
bloc["hash_anterior"] = lant[-1]["hash"] if lant else "0" * 12
bloc["hash"] = h(bloc)
lant.append(bloc)
print(json.dumps(lant[-1], sort_keys=True))De ce merge
Blocul 1 ținea blocul geneză, iar geneza ținea în urmasi blocul 1: un ciclu pe care JSON nu-l poate scrie. Cu hash_anterior = lant[-1]["hash"] legătura e doar un text, deci fiecare bloc se serializează singur. Așa funcționează și un blockchain real: lanțul există pentru că fiecare bloc conține hash-ul celui dinainte.
Alte forme ale mesajului
ValueError: Circular reference detected when serializing dict item 'anterior'ValueError: Circular reference detected when serializing list item 0RecursionError: maximum recursion depth exceeded while encoding a JSON object
Cum o eviți pe viitor
Leagă blocurile, tranzacțiile și nodurile prin identificatori (hash, txid, adresă), nu prin referințe la obiecte. Un bloc trebuie să poată fi serializat singur, fără restul lanțului. Dacă ai nevoie de legături în memorie (de exemplu un arbore de fork-uri), păstrează-le într-o structură separată, pe care n-o serializezi.
Întrebări frecvente
De ce Python nu serializează ciclul ca referință?
Formatul JSON nu are referințe: e doar un arbore de valori. Un ciclu nu poate fi scris ca text JSON.
Am pus check_circular=False și acum primesc RecursionError. De ce?
Fără verificare, dumps intră în ciclu până la limita de recursivitate. Opțiunea doar ascunde problema; reparația e să scoți ciclul.
Erori înrudite
TypeError: Object of type Bloc is not JSON serializable Ai dat lui json.dumps un obiect al clasei tale (Bloc, Tranzactie), pe care JSON nu știe să-l scrie. Transformă-l întâi în dicționar, de exemplu cu o metodă ca_dict() sau cu vars(bloc). Blocul nu trece verificarea: câmpul hash e inclus în propriul hash Calculezi hash-ul blocului din tot dicționarul, inclusiv câmpul hash. La creare câmpul nu exista (sau era gol), la verificare are deja valoarea, deci hash-ul recalculat iese mereu altul. Exclude câmpul hash din datele hash-uite. RecursionError: maximum recursion depth exceeded Funcția ta se apelează pe ea însăși de prea multe ori: la un lanț cu mii de blocuri, o validare recursivă (un apel pe bloc) depășește limita de aproximativ 1000 de apeluri. Scrie validarea cu o buclă for, nu recursiv. Învață Blockchain de la zero, cu exerciții la fiecare lecție
Curs Blockchain și criptomonede: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
