【Python】raiseでエラーを発生させる正しい書き方とNG例まとめ

# シンプルに例外を発生させる例

def do_something():
    # ここでは、何らかの条件で処理を続行できないと判断したとします
    raise RuntimeError("処理を続行できません")

do_something()  # ここでRuntimeErrorが発生する

raise Exception       # 1. 例外クラスを渡す
raise Exception()     # 2. 例外インスタンスを渡す

# 両者が実行時にどう扱われるかを確認する例

def raise_class():
    raise ValueError

def raise_instance():
    raise ValueError("メッセージ付き")

for func in (raise_class, raise_instance):
    try:
        func()
    except ValueError as e:
        print("関数:", func.__name__, "| 型:", type(e), "| メッセージ:", str(e) or "(なし)")

def set_age(age: int):
    # 不正な値が渡された場合はValueErrorをメッセージ付きで発生させる
    if age < 0:
        # 何がダメなのかがすぐ分かるように具体的に書くことが大切です
        raise ValueError("ageは0以上でなければなりません。指定値: {}".format(age))

    print("年齢を{}歳に設定しました。".format(age))

try:
    set_age(-5)
except ValueError as e:
    print("エラー:", e)

def withdraw(balance: int, amount: int) -> int:
    # ガード節(Guard Clause)で不正な条件を早期チェックします
    if amount <= 0:
        raise ValueError("出金額は正の整数でなければなりません。指定額: {}".format(amount))

    if amount > balance:
        raise ValueError("残高不足です。残高: {}, 出金額: {}".format(balance, amount))

    # 条件をクリアした場合のみ本来の処理を行います
    return balance - amount

try:
    new_balance = withdraw(1000, 2000)
except ValueError as e:
    print("エラー発生:", e)

def set_discount_rate(rate: float) -> None:
    """
    割引率を設定する関数です。
    rateは0.0〜1.0の範囲でなければなりません。
    """
    if not isinstance(rate, (int, float)):
        raise TypeError("rateは数値でなければなりません。受け取った型: {}".format(type(rate)))

    if not (0.0 <= rate <= 1.0):
        raise ValueError("rateは0.0〜1.0の範囲で指定してください。指定値: {}".format(rate))

    print("割引率を{:.0%}に設定しました。".format(rate))

try:
    set_discount_rate(1.5)
except (TypeError, ValueError) as e:
    print("設定エラー:", e)

def load_config(path: str) -> dict:
    import json

    try:
        with open(path, "r", encoding="utf-8") as f:
            return json.load(f)
    except FileNotFoundError as e:
        # ファイルが存在しない場合は、より意味の分かりやすい例外に変換する
        raise RuntimeError("設定ファイルが見つかりません: {}".format(path)) from e
    except json.JSONDecodeError as e:
        # JSONの構文が不正な場合も、分かりやすいメッセージをつけて再度raise
        raise RuntimeError("設定ファイルの形式が不正です: {}".format(path)) from e

try:
    config = load_config("config.json")
except RuntimeError as e:
    print("設定読み込みエラー:", e)

import logging

logger = logging.getLogger(__name__)

def process_order(order_id: str) -> None:
    try:
        # ここで何らかの処理を行う想定
        raise ConnectionError("在庫管理システムに接続できません")
    except ConnectionError as e:
        # ログに詳細な情報を残す
        logger.error("注文処理中に接続エラーが発生しました。order_id=%s, error=%s", order_id, e)
        # 上位に知らせるために例外を再度発生させる
        raise

# 実行例(簡易的にコンソールへログを出す設定)
if __name__ == "__main__":
    logging.basicConfig(level=logging.ERROR, format="%(levelname)s:%(name)s:%(message)s")
    try:
        process_order("ORDER-123")
    except ConnectionError:
        print("ユーザー向けには「システムエラーが発生しました」と表示するなどの処理を行う")

# NG例: 何でもExceptionで投げてしまう
def parse_price(text: str) -> int:
    try:
        return int(text)
    except Exception:
        # なんとなく全部Exceptionで投げ直してしまう
        raise Exception("価格の解析に失敗しました")

# 良い例: 具体的な例外クラスを使う
def parse_price(text: str) -> int:
    try:
        return int(text)
    except ValueError as e:
        # もともとValueErrorなので、必要ならメッセージを足して再度ValueErrorとしてraise
        raise ValueError("価格の解析に失敗しました。入力値: {}".format(text)) from e

def divide(a: int, b: int) -> float:
    try:
        return a / b
    except ZeroDivisionError:
        # NG: 元の例外情報を完全に捨ててしまっている
        raise RuntimeError("計算に失敗しました")

def divide(a: int, b: int) -> float:
    try:
        return a / b
    except ZeroDivisionError as e:
        # 良い例1: 元例外をチェーンする
        raise RuntimeError("0で割ろうとしました。a={}, b={}".format(a, b)) from e

def divide_simple(a: int, b: int) -> float:
    try:
        return a / b
    except ZeroDivisionError:
        # 良い例2: メッセージだけ追加した上で同じ例外を再スロー
        raise  # ここで元のZeroDivisionErrorがそのまま再スローされる

# NG例: 例外を握りつぶしてしまう
def do_task():
    try:
        dangerous_operation()
    except Exception:
        # 何もせずにスルーしてしまう
        pass

def dangerous_operation():
    raise RuntimeError("致命的なエラー")

do_task()
print("ここまで到達してしまう")  # 本来は到達すべきでないのに到達してしまう

# 良い例: ログを出してから再スローする
import logging
logger = logging.getLogger(__name__)

def do_task():
    try:
        dangerous_operation()
    except RuntimeError as e:
        logger.error("タスク中に致命的なエラーが発生しました: %s", e)
        raise  # 必ず再スローすることで、上位にエラーを伝えます

def dangerous_operation():
    raise RuntimeError("致命的なエラー")

# NG例: 因果関係がよく分からないのにfromを付けてしまう
def process_data():
    try:
        do_io()
        do_calculation()
    except IOError as e:
        # 実はIOErrorは無関係なのに、計算エラーに無理やりfromでくっつけている
        raise ValueError("計算に失敗しました") from e  # 本当にIOErrorが原因？

def do_io():
    # ここではIOエラーは発生しないとする
    pass

def do_calculation():
    raise ValueError("0割りエラー")

# 良い例: 原因と結果が明確な場合だけfromを使う
def load_user_settings(path: str):
    import json
    try:
        with open(path, "r", encoding="utf-8") as f:
            return json.load(f)
    except (FileNotFoundError, PermissionError, json.JSONDecodeError) as e:
        # 「設定が読み込めなかった」という高レベルなエラーに変換する
        raise RuntimeError("ユーザー設定を読み込めませんでした: {}".format(path)) from e

try:
    do_something()
except ValueError as e:
    logger.warning("値エラーが発生しました: %s", e)
    raise  # fromは書かない