Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

KeyError — chiave mancante in un mapping

KeyError indica che una chiave richiesta non è stata trovata in un mapping, ad esempio un dict. Scopri la differenza tra l’accesso con le parentesi quadre e get(), e gestisci le chiavi mancanti senza nascondere errori non correlati.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

try:
    value = mapping[key]
except KeyError:
    ...

KeyError è un’eccezione incorporata che deriva da LookupError. Segnala che in un mapping manca una chiave richiesta. Per un normale dict, mapping[key] genera questa eccezione quando la chiave non esiste. Non confonderla con IndexError, che riguarda un indice fuori dai limiti di una sequenza.

Se è prevedibile che una chiave manchi, usa try / except KeyError oppure mapping.get(key, default). Per un dict, get() restituisce il valore predefinito solo se la chiave è assente; se non viene specificato un valore predefinito, in quel caso restituisce None. Una chiave esistente con valore None non è una chiave mancante e non fa scattare il valore predefinito. L’espressione key in mapping verifica la presenza della chiave.

Limita il blocco try all’operazione per cui vuoi gestire la chiave mancante, così da non intercettare per errore un KeyError proveniente da un’altra chiamata. Se la chiave è necessaria, correggi i dati di input oppure lascia propagare l’eccezione, invece di ignorarla incondizionatamente.

L’esempio mette a confronto la chiave mancante "language" e la chiave esistente "nickname" con valore None. Nota: una sottoclasse di dict può definire __missing__() e modificare il comportamento di mapping[key] quando la chiave è assente; get() non richiama questo meccanismo.

Esempi

settings = {"theme": "dark", "nickname": None}

try:
    print(settings["language"])
except KeyError:
    print("Missing key: language")

print(settings.get("language", "en"))
print(settings.get("nickname", "guest"))

Risultato

Missing key: language
en
None

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti