...
Eroare Blockchain · Serializarea blocurilor în JSON

ValueError: Circular reference detected

Pe scurt

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

Greșit
PYTHON
geneza = {"index": 0, "urmasi": []}
b1 = {"index": 1, "anterior": geneza}
geneza["urmasi"].append(b1)
json.dumps(b1)
Corect
PYTHON
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

Greșit
PYTHON
lant = []
lant.append(lant)
json.dumps(lant)
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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))
După reparație, programul afișează
{"date": "Bogdan->Carmen:2", "hash": "ddda89602b1e", "hash_anterior": "ed6be42622f1", "index": 2}
Indiciu

Un bloc indică spre cel anterior printr-un text, nu prin obiect.

Alte forme ale mesajului

  • ValueError: Circular reference detected when serializing dict item 'anterior'
  • ValueError: Circular reference detected when serializing list item 0
  • RecursionError: 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

← Toate erorile Blockchain

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ță 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.