最新のPythonでカスタム例外を宣言する方法

最新のPythonにおけるカスタム例外の宣言方法

Pythonでは、標準のExceptionクラスを継承することで、独自の例外クラス（カスタム例外）を簡単に定義できます。例外に追加の引数を持たせたい場合や、既存の挙動を上書きしたい場合は、__init__メソッドをオーバーライドするのが現代的な書き方です。

class ValidationError(Exception):
    def __init__(self, message, errors):
        super(ValidationError, self).__init__(message)
        self.errors = errors

このように定義しておくと、第2引数としてエラーメッセージの辞書（dict）を渡せるようになり、後から必要になったタイミングでその情報を自由に取り出して利用できます。

コードのポイント

• super(ValidationError, self).__init__(message) は親クラスの初期化処理を呼び出しています。Python 3以降では、より簡潔に super().__init__(message) と記述するのが一般的です。
• self.errors に任意のデータ（例：フィールドごとのエラーメッセージをまとめた辞書）を格納することで、例外発生時に詳細なコンテキスト情報を保持できます。

実際の使用例

try:
    raise ValidationError("入力値が不正です", {"email": "メールアドレスの形式が正しくありません"})
except ValidationError as e:
    print(e)         # 入力値が不正です
    print(e.errors)  # {'email': 'メールアドレスの形式が正しくありません'}

このパターンは、フォームバリデーションやAPIの入力チェックなど、複数のエラー情報をひとつの例外にまとめて扱いたい場面で特に役立ちます。メッセージ本体と詳細なエラー内容を分離できるため、ログ出力やユーザーへのエラー表示も柔軟に行えます。