Pythonの例外・エラー処理を網羅！主要な組み込み例外一覧と実装のコツ

2026年5月29日

基礎知識

Pythonプログラミングにおいて、エラー（例外）への適切な対処は、システムの信頼性を高めるために欠かせないスキルです。

プログラムを実行中に発生する予期せぬ事態を放置すると、アプリケーションが突然停止し、ユーザーの利便性を著しく損なう恐れがあります。

本記事では、Pythonで頻繁に遭遇する組み込み例外の一覧から、実践的なエラー処理の実装のコツまでを詳しく解説します。

開発者が自信を持ってコードを記述し、エラーを制御下に置くための知識を深めていきましょう。

目次 [ close ]

Pythonにおける例外処理の重要性と基本構造

Pythonのプログラムを実行している最中に発生するエラーは、大きく分けて「構文エラー（SyntaxError）」と「例外（Exception）」の2種類に分類されます。

構文エラーはプログラムの記述ミスが原因で実行前に検出されますが、例外は実行中に何らかの要因で処理が継続できなくなった際に発生します。

例外処理を適切に実装することで、エラーが発生した際にもプログラムを安全に終了させたり、別の処理に誘導したりすることが可能になります。

Pythonでは、try-except構文を用いるのが例外処理の基本です。

try-exceptの基本的な使い方

まずは、最も標準的な例外処理の書き方を確認しましょう。

Python

try:
    # エラーが発生する可能性のある処理
    number = int("abc")
except ValueError as e:
    # エラーが発生したときの処理
    print(f"エラーが発生しました: {e}")

実行結果

エラーが発生しました: invalid literal for int() with base 10: 'abc'

上記の例では、文字列を整数に変換しようとして失敗した際に、ValueErrorをキャッチしています。

as eと記述することで、発生した例外のインスタンスを変数として受け取り、その内容を表示することが可能です。

elseとfinallyの活用

tryブロックの中でエラーが発生しなかった場合にのみ実行したい処理があるときは、else節を使用します。

また、エラーの有無にかかわらず、ファイルのクローズ処理などの後片付けを必ず行いたい場合には、finally節を記述します。

Python

try:
    result = 10 / 2
except ZeroDivisionError:
    print("0で割ることはできません。")
else:
    print(f"計算結果は {result} です。")
finally:
    print("処理を終了します。")

実行結果

計算結果は 5.0 です。
処理を終了します。

このように、「try、except、else、finally」の4つを組み合わせることで、堅牢なプログラムを構築できます。

主要な組み込み例外一覧

Pythonには多くの組み込み例外が用意されており、エラーの種類に応じて適切な例外が投げられます。

どのようなエラーが発生し得るかを把握しておくことは、デバッグの効率化に直結します。

よく遭遇する主要な例外を以下の表にまとめました。

例外名	発生する主な原因
`SyntaxError`	Pythonの構文が正しくない場合に発生します。
`IndentationError`	インデントの付け方が正しくない場合に発生します。
`TypeError`	演算や関数が不適切な型のオブジェクトに適用された場合に発生します。
`ValueError`	型は正しいが、値の内容が不適切な場合に発生します。
`IndexError`	リストなどのシーケンスで、範囲外のインデックスを指定した場合に発生します。
`KeyError`	辞書型で、存在しないキーを参照した場合に発生します。
`AttributeError`	オブジェクトに存在しない属性やメソッドを参照した場合に発生します。
`ZeroDivisionError`	数値をゼロで除算しようとした場合に発生します。
`FileNotFoundError`	指定したファイルやディレクトリが存在しない場合に発生します。
`ImportError`	import文でモジュールの読み込みに失敗した場合に発生します。

頻出する例外の具体例

実務で特によく見かける例外について、具体的な発生パターンを見ていきましょう。

TypeErrorとValueErrorの違い

この2つは混同されやすいですが、明確な違いがあります。

TypeErrorは「型そのものが違う」場合に発生し、ValueErrorは「型は合っているが中身が適していない」場合に発生します。

Python

# TypeErrorの例: 数値と文字列を足そうとした場合
try:
    total = 10 + "20"
except TypeError as e:
    print(f"Type Error: {e}")

# ValueErrorの例: 数値として不適切な文字列を変換しようとした場合
try:
    num = int("Python")
except ValueError as e:
    print(f"Value Error: {e}")

型をチェックすべきか、値の妥当性をチェックすべきかを区別することが重要です。

IndexErrorとKeyError

データの集合体から要素を取り出す際、対象が存在しないとこれらのエラーが発生します。

Python

# IndexErrorの例
my_list = [1, 2, 3]
try:
    print(my_list[5])
except IndexError as e:
    print(f"Index Error: {e}")

# KeyErrorの例
my_dict = {"name": "Alice"}
try:
    print(my_dict["age"])
except KeyError as e:
    print(f"Key Error: {e}")

リストの要素数や、辞書のキーの有無を確認せずにアクセスすると発生しやすいため、注意が必要です。

実践的な例外処理の実装のコツ

例外処理をただ記述するだけでなく、保守性の高いコードを書くためのテクニックを解説します。

具体的な例外クラスを指定する

すべての例外をキャッチしようとして、except:やexcept Exception:とだけ記述するのは推奨されません。

広すぎる例外指定は、予期せぬバグ（例えばタイポによるNameErrorなど）までも隠蔽してしまうからです。

可能な限り、発生が予想される具体的な例外クラスを指定するようにしましょう。

Python

# 良い例
try:
    value = my_dict["data"]
except KeyError:
    print("データが見つかりません。")

# 避けるべき例
try:
    value = my_dict["data"]
except:
    print("何らかのエラーが発生しました。")

例外をわざと発生させる (raise)

プログラムのロジック上、特定の条件下でエラーとして扱いたい場合は、raiseキーワードを使って自ら例外を発生させることができます。

Python

def check_age(age):
    if age < 0:
        raise ValueError("年齢に負の値は指定できません。")
    return age

try:
    check_age(-5)
except ValueError as e:
    print(e)

これにより、不正なデータが後続の処理に渡されるのを未然に防ぐことができます。

独自の例外クラスを作成する

アプリケーション固有のエラーを定義したい場合は、Exceptionクラスを継承して独自の例外クラスを作成します。

Python

class MyAppError(Exception):
    """自作アプリケーション専用の例外クラス"""
    pass

def do_something():
    raise MyAppError("カスタムエラーが発生しました")

try:
    do_something()
except MyAppError as e:
    print(e)

独自例外を使うことで、ライブラリのエラーと自作コードのエラーを明確に区別でき、デバッグが容易になります。

高度なエラーハンドリング技術

よりモダンで安全なプログラムを書くための応用的な手法を紹介します。

with文（コンテキストマネージャ）による自動クローズ

ファイル操作やネットワーク接続など、終了後にリソースを解放する必要がある処理では、with文を使用するのが最適です。

with文を使用すると、たとえ処理中に例外が発生しても、自動的にクローズ処理が行われます。

Python

try:
    with open("sample.txt", "r", encoding="utf-8") as f:
        content = f.read()
except FileNotFoundError:
    print("ファイルが見つかりません。")

これは、try-finallyでクローズ処理を書くよりも簡潔で、クローズ漏れを防げるため非常に安全です。

ロギングによるエラー情報の蓄積

商用環境で動作するプログラムでは、print関数ではなくloggingモジュールを使用してエラーを記録するのが一般的です。

ログをファイルに出力しておくことで、後からエラーの発生状況やスタックトレース（エラーに至るまでの経緯）を詳細に分析できます。

Python

import logging

logging.basicConfig(level=logging.ERROR, filename='error.log')

try:
    x = 1 / 0
except ZeroDivisionError:
    logging.exception("ゼロ除算エラーが発生しました。")

logging.exceptionを使用すると、スタックトレースが自動的にログに含まれるため非常に便利です。

例外の連鎖 (Exception Chaining)

ある例外をキャッチして別の例外として再送出したい場合、fromキーワードを使って元のエラー情報を引き継ぐことができます。

Python

try:
    # 実際には存在しない処理
    int("data")
except ValueError as e:
    raise RuntimeError("データ処理に失敗しました") from e

これにより、根本的な原因が何であったかを追跡しやすくなります。

まとめ

Pythonの例外処理は、単にエラーを止めるための仕組みではなく、プログラムの挙動をコントロールするための強力なツールです。

try-exceptの基本をマスターし、ValueErrorやKeyErrorといった主要な組み込み例外の特性を理解することで、予期せぬ停止に強いコードを書けるようになります。

また、独自の例外クラスやロギングの活用、with文によるリソース管理など、実践的なテクニックを取り入れることで、コードの品質は格段に向上します。

まずは小さな処理から具体的な例外指定を行い、エラーを恐れずに適切にハンドリングする習慣を身につけていきましょう。

エラーはプログラムを改善するためのヒントを教えてくれる貴重な情報源です。

本記事で紹介した一覧と実装のコツを参考に、より安全で信頼性の高いPythonプログラミングを追求してください。