ValueError: dict contains fields not in fieldnames: 'email'
csv.DictWriter a primit un dicționar cu o cheie care nu e în lista fieldnames, deci nu știe în ce coloană s-o scrie. Adaugă cheia în fieldnames, scoate-o din dicționar, sau folosește extrasaction="ignore" ca să fie ignorată.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
csv.DictWriter(f, fieldnames=[...]) scrie dicționare ca rânduri CSV, în ordinea coloanelor din fieldnames. Pentru fiecare rând, verifică cheile dicționarului: dacă găsește una care nu are coloană, refuză să o arunce în tăcere și ridică ValueError: dict contains fields not in fieldnames: 'email', cu cheile în plus.
Cazuri tipice: datele vin dintr-un API sau din baza de date și au câmpuri în plus față de cele pe care vrei să le exporți, ai scris o cheie diferit (Email față de email, pret cu spațiu), sau ai adăugat un câmp nou în cod fără să-l adaugi și în fieldnames.
Invers, cheile care lipsesc din dicționar nu dau eroare: coloana rămâne goală (valoarea din restval, implicit "").
De ce apare: cauzele frecvente
1Câmp în plus în date
import csv, io
f = io.StringIO()
w = csv.DictWriter(f, fieldnames=["nume", "oras"])
w.writerow({"nume": "Ana", "oras": "Cluj", "email": "ana@exemplu.ro"})import csv, io
f = io.StringIO()
w = csv.DictWriter(f, fieldnames=["nume", "oras"], extrasaction="ignore")
w.writerow({"nume": "Ana", "oras": "Cluj", "email": "ana@exemplu.ro"})
print(f.getvalue().strip())extrasaction="ignore" spune explicit că restul câmpurilor nu te interesează.
2Cheie scrisă diferit
import csv, io
f = io.StringIO()
w = csv.DictWriter(f, fieldnames=["produs", "pret"])
w.writerow({"produs": "pix", "Pret": 5})import csv, io
f = io.StringIO()
w = csv.DictWriter(f, fieldnames=["produs", "pret"])
w.writerow({"produs": "pix", "pret": 5})
print(f.getvalue().strip())Cheile trebuie să fie identice cu numele coloanelor, inclusiv literele mari și spațiile.
Repară eroarea, direct în pagină
Programul exportă o listă de clienți într-un CSV cu doar două coloane, nume și oras, dar datele au și câmpul email, iar writerow dă ValueError: dict contains fields not in fieldnames: 'email'. Repară exportul (fără să modifici lista clienti) ca programul să afișeze antetul și două rânduri: nume,oras, Ana,Cluj, Dan,Iași.
import csv
import io
clienti = [
{"nume": "Ana", "oras": "Cluj", "email": "ana@exemplu.ro"},
{"nume": "Dan", "oras": "Iași", "email": "dan@exemplu.ro"},
]
f = io.StringIO()
scriitor = csv.DictWriter(f, fieldnames=["nume", "oras"], lineterminator="\n")
scriitor.writeheader()
scriitor.writerows(clienti)
print(f.getvalue().strip())nume,oras Ana,Cluj Dan,Iași
Indiciu
DictWriter poate primi o opțiune care ignoră câmpurile fără coloană.
Reparația
import csv
import io
clienti = [
{"nume": "Ana", "oras": "Cluj", "email": "ana@exemplu.ro"},
{"nume": "Dan", "oras": "Iași", "email": "dan@exemplu.ro"},
]
f = io.StringIO()
scriitor = csv.DictWriter(f, fieldnames=["nume", "oras"], lineterminator="\n", extrasaction="ignore")
scriitor.writeheader()
scriitor.writerows(clienti)
print(f.getvalue().strip())De ce merge
Implicit, DictWriter refuză dicționarele cu chei pentru care nu are coloană, ca să nu piardă date fără să știi. Cu extrasaction="ignore", îi spui explicit că email nu trebuie exportat, iar el scrie doar coloanele din fieldnames, în ordinea lor. lineterminator="\n" păstrează capetele de rând simple.
Alte forme ale mesajului
ValueError: dict contains fields not in fieldnames: 'email', 'telefon'ValueError: dict contains fields not in fieldnames: 'Pret'
Cum o eviți pe viitor
- Hotărăște explicit ce coloane exporți și ține-le într-o constantă (
COLOANE = [...]). - Când datele au câmpuri în plus, folosește
extrasaction="ignore"sau construiește dicționare noi doar cu cheile dorite. - Dacă vrei toate câmpurile, calculează
fieldnamesdin date:list(randuri[0].keys()). - Nu uita
writeheader()înainte de rânduri, ca fișierul să aibă antet.
Întrebări frecvente
Ce se întâmplă dacă lipsește o cheie din dicționar?
Nu dă eroare: coloana rămâne goală sau primește valoarea dată în restval= la crearea lui DictWriter.
E mai bine extrasaction="ignore" sau să filtrez eu cheile?
Ambele merg. ignore e mai scurt; filtrarea explicită te ajută să observi când datele se schimbă neașteptat. Valoarea implicită, "raise", e cea mai sigură: te anunță când trimiți date pe care nu le aștepți.
Erori înrudite
_csv.Error: iterator should return strings, not bytes (the file should be opened in text mode) Ai dat modulului csv un fișier deschis binar ("rb") sau octeți primiți din rețea. csv lucrează cu text. Deschide fișierul în mod text: open(cale, newline="", encoding="utf-8"), iar pentru octeți folosește io.StringIO(date.decode("utf-8")). KeyError: 'pret' Ceri dintr-un dicționar o cheie care nu există. Mesajul îți arată cheia căutată. Verifică scrierea exactă (litere mari, diacritice, spații), folosește `d.get(cheie, implicit)` dacă cheia poate lipsi sau verifică întâi cu `if cheie in d`. TypeError: write() argument must be str, not int Metoda `write()` a unui fișier deschis în mod text primește doar texte, iar tu i-ai dat un număr (sau o listă, un dicționar). Spre deosebire de `print`, `write` nu convertește singur. Scrie `f.write(str(x))` sau, mai bine, `f.write(f"{x}\n")`. Î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.
