...
Eroare Python · Funcții, clase și argumente

ValueError: mutable default <class 'list'> for field produse is not allowed: use default_factory

Pe scurt

Într-un `@dataclass` ai dat unui câmp o listă (sau un dicționar, un set) ca valoare implicită: `produse: list = []`. Folosește `field(default_factory=list)`, ca fiecare obiect să primească propria listă nouă.

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

Ce înseamnă

O valoare implicită scrisă în clasă e creată o singură dată și ar fi folosită de toate obiectele. La o listă, asta ar însemna că toate coșurile împart aceeași listă de produse: adaugi un produs într-un coș și apare în toate. E aceeași capcană ca la funcțiile cu def f(x=[]).

Ca să te ferească de ea, @dataclass refuză valorile implicite mutabile (list, dict, set) și îți spune soluția chiar în mesaj: use default_factory. field(default_factory=list) îi spune dataclass-ului să cheme list() la crearea fiecărui obiect, deci fiecare obiect are lista lui. Mesajul apare pe linia cu @dataclass, când se definește clasa, nu când creezi obiecte.

De ce apare: cauzele frecvente

1Listă goală ca valoare implicită

Greșit
PYTHON
from dataclasses import dataclass
@dataclass
class Cos:
    produse: list = []
Corect
PYTHON
from dataclasses import dataclass, field
@dataclass
class Cos:
    produse: list = field(default_factory=list)

default_factory=list creează o listă nouă pentru fiecare coș.

2Dicționar cu valori de pornire

Greșit
PYTHON
from dataclasses import dataclass
@dataclass
class Setari:
    optiuni: dict = {"tema": "deschis"}
Corect
PYTHON
from dataclasses import dataclass, field
@dataclass
class Setari:
    optiuni: dict = field(default_factory=lambda: {"tema": "deschis"})
print(Setari())

Pentru o valoare de pornire nevidă, dai o funcție (aici un lambda) care construiește un dicționar nou de fiecare dată.

Repară tu

Repară eroarea, direct în pagină

Dataclass-ul Cos de mai jos dă ValueError: mutable default <class 'list'> for field produse is not allowed: use default_factory. Repară câmpul produse, ca programul să afișeze Cos(client='Ana', produse=['pix']).

Codul care dă eroarea
PYTHON
from dataclasses import dataclass

@dataclass
class Cos:
    client: str
    produse: list = []

c = Cos("Ana")
c.produse.append("pix")
print(c)
După reparație, programul afișează
Cos(client='Ana', produse=['pix'])
Indiciu

Importă field din dataclasses și folosește default_factory.

Alte forme ale mesajului

  • ValueError: mutable default <class 'dict'> for field optiuni is not allowed: use default_factory
  • ValueError: mutable default <class 'set'> for field etichete is not allowed: use default_factory

Cum o eviți pe viitor

  • Pentru câmpuri de tip listă, dicționar sau set, folosește mereu field(default_factory=...).
  • Aplică aceeași regulă la funcții: în loc de def f(x=[]), scrie def f(x=None) și if x is None: x = [].
  • Valorile imutabile (0, "", None, tupluri) pot fi valori implicite normale.

Întrebări frecvente

De ce funcțiile acceptă x=[], dar dataclass-urile nu?

Funcțiile acceptă, dar comportamentul e aproape mereu un bug: lista e împărțită între apeluri. Dataclass-urile au ales să te oprească de la început.

Pot folosi un tuplu ca valoare implicită?

Da, un tuplu e imutabil, deci etichete: tuple = () e permis. Nu-l poți modifica după creare, ceea ce elimină problema.

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.