...
Eroare Python · Valori greșite și conversii

ValueError: 4 is not a valid Status

Pe scurt

Ai cerut un membru al unui Enum după valoare, Status(4), dar niciun membru nu are valoarea 4. Verifică valorile definite în Enum (și tipul lor: "4" text nu e 4 număr) sau tratează valorile necunoscute cu try/except ValueError.

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

Ce înseamnă

Un Enum asociază nume cu valori: class Status(Enum): NOU = 1; PLATIT = 2. Când scrii Status(2), Python caută membrul care are valoarea 2 și întoarce Status.PLATIT. Dacă nu găsește niciunul, ridică ValueError: 4 is not a valid Status, cu valoarea căutată și numele enum-ului.

Cele mai dese cauze: valoarea vine dintr-o sursă externă (bază de date, JSON, formular) și are alt tip ("2" ca text în loc de 2), cauți după nume, nu după valoare (Status("PLATIT") în loc de Status["PLATIT"]), sau sursa conține o valoare nouă pe care enum-ul tău nu o are încă.

Atenție la diferență: căutarea după nume cu paranteze pătrate dă altă eroare, KeyError: 'ANULAT', când numele nu există.

De ce apare: cauzele frecvente

1Valoarea vine ca text

Greșit
PYTHON
from enum import Enum

class Status(Enum):
    NOU = 1
    PLATIT = 2

print(Status("2"))
Corect
PYTHON
from enum import Enum

class Status(Enum):
    NOU = 1
    PLATIT = 2

print(Status(int("2")))

Membrii au valori numerice, iar "2" nu e egal cu 2. Conversia rezolvă potrivirea.

2Căutare după nume cu paranteze rotunde

Greșit
PYTHON
from enum import Enum

class Status(Enum):
    NOU = 1
    PLATIT = 2

print(Status("PLATIT"))
Corect
PYTHON
from enum import Enum

class Status(Enum):
    NOU = 1
    PLATIT = 2

print(Status["PLATIT"])

Status(...) caută după valoare, Status[...] după nume.

3Valoare nouă, necunoscută

Greșit
PYTHON
from enum import Enum

class Status(Enum):
    NOU = 1
    PLATIT = 2

print(Status(4))
Corect
PYTHON
from enum import Enum

class Status(Enum):
    NOU = 1
    PLATIT = 2

try:
    print(Status(4))
except ValueError:
    print("status necunoscut")

Când datele pot conține valori noi, prinde ValueError și decide explicit ce faci cu ele.

Repară tu

Repară eroarea, direct în pagină

Programul citește starea unei comenzi dintr-un JSON, unde e salvată ca text, și o transformă în membrul enum-ului Status, dar dă ValueError: '2' is not a valid Status. Repară conversia ca programul să afișeze PLATIT.

Codul care dă eroarea
PYTHON
import json
from enum import Enum

class Status(Enum):
    NOU = 1
    PLATIT = 2
    LIVRAT = 3

comanda = json.loads('{"id": 15, "status": "2"}')
status = Status(comanda["status"])
print(status.name)
După reparație, programul afișează
PLATIT
Indiciu

Valorile membrilor sunt numere, iar din JSON vine un text.

Alte forme ale mesajului

  • ValueError: '2' is not a valid Status
  • ValueError: 'PLATIT' is not a valid Status
  • KeyError: 'ANULAT'

Cum o eviți pe viitor

  • Convertește valorile externe la tipul membrilor înainte de Status(valoare).
  • Folosește Status[nume] pentru nume și Status(valoare) pentru valori.
  • Pentru enum-uri cu valori text, StrEnum (Python 3.11+) face potrivirea cu textele mai naturală.
  • Dacă vrei o valoare implicită pentru cazurile necunoscute, definește metoda de clasă _missing_ în enum.

Întrebări frecvente

Cum văd toate valorile valide ale unui enum?

[s.value for s in Status] dă lista valorilor, iar [s.name for s in Status] lista numelor.

Pot face ca enum-ul să întoarcă o valoare implicită în loc de eroare?

Da, cu @classmethod def _missing_(cls, valoare): return cls.NOU. Python o cheamă când nu găsește valoarea; folosește-o doar dacă o valoare implicită are sens pentru datele tale.

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.