【Python】エラーコードとエラーメッセージを含むカスタム例外クラスの作成方法

Pythonでは、Exceptionクラスを継承した独自の例外クラスを定義することで、エラーコードやエラーメッセージを自由に組み込んだカスタム例外を作成できます。ここでは、代表的な実装パターンを2つ紹介します。

エラーコードを持つカスタム例外

まず、例外クラスにエラーコードを持たせる基本的な例です。__init__メソッドでコードを受け取り、インスタンス属性として保持します。

class ErrorCode(Exception):
    def __init__(self, code):
        self.code = code

try:
    raise ErrorCode(401)
except ErrorCode as e:
    print("Received error with code:", e.code)

このコードを実行すると、次のような出力が得られます。

Received error with code: 401

引数・エラーコード・エラーメッセージを組み合わせたカスタム例外

可変長引数（*args）を活用すれば、エラーコードだけでなく、複数のメッセージやデータをまとめて例外オブジェクトに渡すことも可能です。

class ErrorArgs(Exception):
    def __init__(self, *args):
        self.args = [a for a in args]

try:
    raise ErrorArgs(403, "foo", "bar")
except ErrorArgs as e:
    print("%d: %s , %s" % (e.args[0], e.args[1], e.args[2]))

実行結果は以下のとおりです。

403: foo , bar

実装のポイント

• Exceptionクラスを継承するだけで、独自の例外クラスを簡単に作成できます。
• __init__メソッド内で属性を定義すれば、エラーコードやメッセージなど任意の情報を保持できます。
• *argsを使うことで、呼び出し側から柔軟に複数の引数を渡せます。

このようにカスタム例外を活用すると、エラー発生時の状況をより詳細に伝えられ、デバッグやログ出力の精度も向上します。プロジェクトごとに共通の例外クラスを設計しておくと、エラーハンドリングの一貫性も保てるでしょう。