...
Eroare Python · Date: JSON, text și date calendaristice

ValueError: dict contains fields not in fieldnames: 'email'

Pe scurt

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

Greșit
PYTHON
import csv, io
f = io.StringIO()
w = csv.DictWriter(f, fieldnames=["nume", "oras"])
w.writerow({"nume": "Ana", "oras": "Cluj", "email": "ana@exemplu.ro"})
Corect
PYTHON
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

Greșit
PYTHON
import csv, io
f = io.StringIO()
w = csv.DictWriter(f, fieldnames=["produs", "pret"])
w.writerow({"produs": "pix", "Pret": 5})
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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())
După reparație, programul afișează
nume,oras
Ana,Cluj
Dan,Iași
Indiciu

DictWriter poate primi o opțiune care ignoră câmpurile fără coloană.

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ă fieldnames din 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

← 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.