Key error python json

• Что обычно означает PythonKeyError

• Где еще вы могли бы увидетьKeyError в стандартной библиотеке

• Как обращаться сKeyError, когда вы его видите

Что обычно означаетKeyError в Python

PythonKeyErrorexception — это то, что возникает, когда вы пытаетесь получить доступ к ключу, которого нет вdictionary (dict).

official documentation в Python говорит, чтоKeyError вызывается при обращении к ключу сопоставления и не обнаруживается в сопоставлении. Отображение — это структура данных, которая отображает один набор значений в другой. Наиболее распространенным отображением в Python является словарь.

PythonKeyError является типом исключенияLookupError и означает, что возникла проблема с получением ключа, который вы искали. Когда вы видитеKeyError, семантическое значение состоит в том, что искомый ключ не может быть найден.

В приведенном ниже примере вы можете увидеть словарь (ages) с возрастом трех человек. Когда вы пытаетесь получить доступ к ключу, которого нет в словаре, возникаетKeyError:

>>>

>>> ages = {'Jim': 30, 'Pam': 28, 'Kevin': 33}
>>> ages['Michael']
Traceback (most recent call last):
  File "", line 1, in 
KeyError: 'Michael'

Здесь попытка доступа к ключу'Michael' в словареages приводит к подъемуKeyError. В нижней части трассировки вы получите соответствующую информацию:

Строка от последней к последней говорит вам, какая строка вызвала исключение. Эта информация более полезна, когда вы выполняете код Python из файла.

Note: Когда в Python возникает исключение, это делается с помощьюtraceback. Трассировка предоставляет вам всю необходимую информацию, чтобы определить, почему возникло исключение и что его вызвало.

Умение читать трассировку Python и понимание того, что он говорит вам, крайне важно для улучшения как программиста на Python.

В приведенной ниже программе вы можете снова увидеть словарьages. На этот раз вам будет предложено указать имя человека, для которого необходимо узнать возраст:

 1 # ages.py
 2
 3 ages = {'Jim': 30, 'Pam': 28, 'Kevin': 33}
 4 person = input('Get age for: ')
 5 print(f'{person} is {ages[person]} years old.')

Этот код примет имя, которое вы указали в приглашении, и попытается определить возраст этого человека. Все, что вы вводите в командной строке, будет использоваться как ключ к словарюages в строке 4.

Повторяя неудачный пример выше, мы получаем еще одну трассировку, на этот раз с информацией о строке в файле, из которой возникаетKeyError:

$ python ages.py
Get age for: Michael
Traceback (most recent call last):
File "ages.py", line 4, in 
  print(f'{person} is {ages[person]} years old.')
KeyError: 'Michael'

Программа не работает, когда вы даете ключ, которого нет в словаре. Здесь последние несколько строк трассировки указывают на проблему. File "ages.py", line 4, in <module> сообщает вам, в какой строке какого файла возникло исключениеKeyError. Тогда вам показывают эту линию. Наконец, исключениеKeyError предоставляет недостающий ключ.

Итак, вы можете видеть, что последняя строка трассировкиKeyError сама по себе не дает вам достаточно информации, но строки перед ней могут значительно приблизить вас к пониманию того, что пошло не так.

Note: Как и в примере выше, большинство других примеров в этом руководстве используютf-strings, которые были введены в Python 3.6.

Где еще вы могли бы увидеть PythonKeyError в стандартной библиотеке

В подавляющем большинстве случаев вызывается PythonKeyError, потому что ключ не найден в словаре или подклассе словаря (например,os.environ).

В редких случаях вы также можете увидеть его поднятым в других местах стандартной библиотеки Python, например, в модулеzipfile, если элемент не найден в ZIP-архиве. Однако эти места сохраняют то же семантическое значение PythonKeyError, которое не находит запрошенный ключ.

В следующем примере вы можете увидеть использование классаzipfile.ZipFile для извлечения информации о ZIP-архиве с помощью.getinfo():

>>>

>>> from zipfile import ZipFile
>>> zip_file = ZipFile('the_zip_file.zip')
>>> zip_file.getinfo('something')
Traceback (most recent call last):
File "", line 1, in 
File "/path/to/python/installation/zipfile.py", line 1304, in getinfo
  'There is no item named %r in the archive' % name)
KeyError: "There is no item named 'something' in the archive"

Это не похоже на поиск по словарю. Вместо этого это вызовzipfile.ZipFile.getinfo() вызывает исключение.

Трассировка также выглядит немного иначе, поскольку предоставляется немного больше информации, чем просто отсутствующий ключ:KeyError: "There is no item named 'something' in the archive".

И последнее, на что следует обратить внимание, это то, что строки, которая поднялаKeyError, нет в вашем коде. Он находится в кодеzipfile, но предыдущие строки трассировки указывают, какие строки в вашем коде вызвали проблему.

Когда вам нужно поднять PythonKeyError в собственном коде

Бывают случаи, когдаyou to raise является исключением PythonKeyError в вашем собственном коде. Это можно сделать, используя ключевое словоraise и вызывая исключениеKeyError:

Обычно отсутствующим ключом являетсяmessage. Однако, как и в случае с пакетомzipfile, вы можете указать немного больше информации, чтобы помочь следующему разработчику лучше понять, что пошло не так.

Если вы решили поднять PythonKeyError в своем собственном коде, просто убедитесь, что ваш вариант использования соответствует семантическому значению исключения. Следует отметить, что искомый ключ не может быть найден.

Как обращаться с PythonKeyError, когда вы его видите

Когда вы сталкиваетесь сKeyError, есть несколько стандартных способов справиться с этим. В зависимости от вашего варианта использования, некоторые из этих решений могут быть лучше, чем другие. Конечная цель — предотвратить возникновение неожиданных исключенийKeyError.

 1 # ages.py
 2
 3 ages = {'Jim': 30, 'Pam': 28, 'Kevin': 33}
 4 person = input('Get age for: ')
 5 age = ages.get(person)
 6
 7 if age:
 8     print(f'{person} is {age} years old.')
 9 else:
10     print(f"{person}'s age is unknown.")

$ python ages.py
Get age for: Michael
Michael's age is unknown.

age = ages.get(person, 0)

 1 # parse_api_response.py
 2 ...
 3 # Assuming you got a `response` from calling an API that might
 4 # have an error key in the `response` if something went wrong
 5
 6 if 'error' in response:
 7     ...  # Parse the error state
 8 else:
 9     ...  # Parse the success state

 1 # ages.py
 2
 3 ages = {'Jim': 30, 'Pam': 28, 'Kevin': 33}
 4 person = input('Get age for: ')
 5
 6 try:
 7     print(f'{person} is {ages[person]} years old.')
 8 except KeyError:
 9     print(f"{person}'s age is unknown.")

>>> from zipfile import ZipFile
>>> zip = ZipFile('the_zip_file.zip')
>>> try:
...     zip.getinfo('something')
... except KeyError:
...     print('Can not find "something"')
...
Can not find "something"

Заключение

Теперь вы знаете несколько распространенных мест, где может возникнуть исключениеKeyErrorв Python, и несколько отличных решений, которые можно использовать, чтобы предотвратить остановку вашей программы.

Теперь, когда вы в следующий раз увидите поднятыйKeyError, вы поймете, что это, вероятно, просто неверный поиск ключа словаря. Вы также сможете найти всю информацию, необходимую для определения источника ошибки, взглянув на последние несколько строк трассировки.

Если проблема заключается в поиске ключа словаря в вашем собственном коде, вы можете переключиться с доступа к ключу непосредственно в словаре на использование более безопасного метода.get() с возвращаемым значением по умолчанию. Если проблема не в вашем собственном коде, то использование блокаtryexcept — лучший вариант для управления потоком кода.

Исключения не должны быть страшными. Как только вы поймете, как понимать информацию, предоставленную вам в их трассировках, и основную причину исключения, вы можете использовать эти решения, чтобы сделать ваши программы более предсказуемыми.