PythonでKeyError例外をキャッチする方法をわかりやすく解説

Pythonでは、辞書（dict）に存在しないキーを使って値へアクセスしようとすると、KeyError例外が発生します。この記事では、try-except文を使ってKeyErrorをキャッチし、例外の種類や詳細情報を確認する方法を解説します。

KeyErrorが発生する仕組み

次のコードは、辞書に存在しないキー 'c' で値を取得しようとしているため、KeyErrorが発生します。sys.exc_info() を使うと、発生した例外の型などの情報を取得できます。

import sys

try:
    s = {'a': 5, 'b': 7}['c']
except:
    print(sys.exc_info())

実行結果

(<class 'KeyError'>, KeyError('c'), <traceback object at 0x0000000003203748>)

出力には、例外の型（KeyError）、例外オブジェクト（見つからなかったキー名 'c'）、トレースバックオブジェクト の3つの情報がタプル形式で格納されています。これにより、どのキーが原因で例外が発生したのかを特定できます。

より実践的な例外処理の書き方

sys.exc_info() の代わりに、as 句を使うと、より読みやすくモダンなコードになります。例外オブジェクトから直接キー名を取得できます。

try:
    s = {'a': 5, 'b': 7}['c']
except KeyError as e:
    print(f"キー '{e}' は辞書に存在しません")

get()メソッドでKeyError自体を回避する

そもそも例外を発生させたくない場合は、get() メソッドが便利です。キーが存在しない場合でも、指定したデフォルト値を返すため、プログラムが中断されません。

s = {'a': 5, 'b': 7}.get('c', 0)
print(s)  # 0 が出力される

まとめ

• 存在しないキーで辞書にアクセスすると、KeyError例外が発生する
• try-except文でキャッチし、sys.exc_info() で例外の型や詳細情報を取得できる
• except KeyError as e の形式を使うと、より簡潔で可読性の高いコードになる
• get() メソッドを使えば、デフォルト値を返して例外の発生自体を防げる