WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

KeyError — fehlender Schlüssel in einer Zuordnung

KeyError bedeutet, dass ein angeforderter Schlüssel in einer Zuordnung, etwa einem dict, nicht gefunden wurde. Erfahre den Unterschied zwischen dem Zugriff mit eckigen Klammern und get() und behandle fehlende Schlüssel, ohne andere Fehler zu verdecken.

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

Syntax

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

KeyError ist eine eingebaute Ausnahme, die von LookupError abgeleitet ist. Sie signalisiert, dass ein angeforderter Schlüssel in einer Zuordnung fehlt. Bei einem gewöhnlichen dict löst mapping[key] diese Ausnahme aus, wenn der Schlüssel nicht existiert. Verwechsle sie nicht mit IndexError, der einen Index außerhalb des Bereichs einer Sequenz betrifft.

Wenn ein fehlender Schlüssel zu erwarten ist, verwende try / except KeyError oder mapping.get(key, default). Bei einem dict gibt get() den Standardwert nur zurück, wenn der Schlüssel fehlt; ohne ausdrücklich angegebenen Standardwert wird in diesem Fall None zurückgegeben. Ein vorhandener Schlüssel mit dem Wert None gilt nicht als fehlend und löst die Rückgabe des Standardwerts nicht aus. Mit key in mapping prüfst du, ob der Schlüssel enthalten ist.

Beschränke den try-Block auf den Vorgang, bei dem du einen fehlenden Schlüssel behandeln möchtest. So fängst du nicht versehentlich einen KeyError aus einem anderen Aufruf ab. Ist der Schlüssel erforderlich, korrigiere die Eingabe oder lass die Ausnahme weitergegeben werden, statt sie bedingungslos zu ignorieren.

Das Beispiel stellt dem fehlenden Schlüssel "language" den vorhandenen Schlüssel "nickname" mit dem Wert None gegenüber. Hinweis: Eine dict-Unterklasse kann __missing__() definieren und damit ändern, wie mapping[key] mit einem fehlenden Schlüssel umgeht; get() ruft diesen Mechanismus nicht auf.

Beispiele

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"))

Ergebnis

Missing key: language
en
None

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen