Python raise文の使い方｜エラー発生の基本からカスタム例外まで解説

2026年5月8日

例外処理・デバッグ

Pythonプログラミングにおいて、プログラムの実行中に意図的にエラーを発生させたい場面は多々あります。

そのような際に使用されるのがraise文であり、エラーハンドリングの根幹を支える重要な機能です。

raise文を適切に使いこなすことで、プログラムのバグを早期に発見したり、呼び出し元に適切なエラー情報を伝えたりすることが可能になります。

本記事では、Pythonにおけるraise文の基本的な使い方から、実務で役立つカスタム例外の作成方法までを詳しく解説します。

目次 [ close ]

raise文とは何か

Pythonのraise文は、プログラムの中で意図的に例外（エラー）を発生させるためのキーワードです。

通常、エラーはゼロ除算や存在しないファイルへのアクセスなど、予期せぬ操作が行われた際に自動的に発生します。

しかし、開発者が定義した特定の条件を満たさない場合に、あえてエラーを投げることで処理を中断させたいケースがあります。

例えば、関数の引数に不正な値が渡された際、そのまま処理を継続すると重大な不具合を招く可能性があるため、raiseを使って即座に通知を行います。

このように、エラーを能動的に制御することは、堅牢なアプリケーションを開発する上で欠かせないスキルとなります。

raise文の基本的な使い方

まずは、最もシンプルに例外を発生させる方法を見ていきましょう。

raiseの後に例外クラスを指定することで、そのエラーを発生させることができます。

例外クラスを指定して発生させる

最も一般的な記述方法は、raiseに続けて例外の種類（クラス）を記述する方法です。

Python

# 値が負の場合にValueErrorを発生させる例
def check_positive(number):
    if number < 0:
        raise ValueError("入力された値が負の数です。")
    return number

try:
    check_positive(-10)
except ValueError as e:
    print(f"エラーが発生しました: {e}")

実行結果

エラーが発生しました: 入力された値が負の数です。

上記のコードでは、引数が0未満の場合にValueErrorを意図的に発生させています。

例外クラスの括弧内には、エラー内容を説明するメッセージを記述するのが一般的です。

引数なしでraiseを使用する場合

raiseは、引数を指定せずに単体で使用することも可能です。

ただし、この使い方は主にexceptブロックの中で、キャッチした例外をそのまま再送出（リレイズ）する場合に限られます。

Python

try:
    result = 10 / 0
except ZeroDivisionError:
    print("ログ記録：ゼロ除算が発生しました。")
    # キャッチした例外をそのまま外側に投げる
    raise

この記述により、エラーのログだけを残しつつ、プログラムの停止判断は呼び出し元に委ねるといった柔軟な設計が可能になります。

よく使われる標準例外クラス

Pythonには多くの組み込み例外が用意されています。

raiseを使用する際は、状況に適した例外クラスを選択することが推奨されます。

例外クラス名	発生させるべき主な状況
`ValueError`	関数の引数の型は正しいが、値が適切でない場合（例：負の数など）
`TypeError`	演算や関数に不適切な型のオブジェクトが渡された場合
`IndexError`	リストなどのシーケンスのインデックスが範囲外の場合
`KeyError`	辞書で存在しないキーを指定した場合
`FileNotFoundError`	指定したファイルやディレクトリが見つからない場合
`RuntimeError`	他のどのカテゴリにも当てはまらない実行時のエラー

適切な例外クラスを選択することで、except節で特定の条件だけをキャッチしやすくなり、コードの可読性が大幅に向上します。

例外の連鎖（Exception Chaining）

複雑なアプリケーションでは、ある例外をきっかけに別の例外を発生させたい場面があります。

Pythonではraise ... from ...という構文を用いることで、エラーの因果関係を明確に記録できます。

raise from の使い方

fromキーワードを使用すると、元の例外情報を保持したまま新しい例外を投げることができます。

Python

def process_data(data):
    try:
        return int(data)
    except ValueError as e:
        # ValueErrorを原因として、独自のRuntimeErrorを発生させる
        raise RuntimeError("データの変換中に問題が発生しました。") from e

try:
    process_data("文字列")
except RuntimeError as e:
    print(f"現在の例外: {e}")
    print(f"元の原因: {e.__cause__}")

実行結果

現在の例外: データの変換中に問題が発生しました。
元の原因: invalid literal for int() with base 10: '文字列'

この手法は、低レベルなエラーをアプリケーション固有の高レベルなエラーにラップする場合に非常に有効です。

デバッグ時に「なぜこのエラーが起きたのか」という履歴を辿れるため、保守性が高まります。

カスタム例外の作成と活用

標準の例外クラスだけでは、特定の業務ロジックにおけるエラーを十分に表現できないことがあります。

その場合、独自の例外クラスを定義してraiseすることができます。

カスタム例外の定義方法

カスタム例外を作成するには、Pythonの組み込みクラスであるExceptionクラスを継承します。

Python

# 独自の例外クラスを定義
class InsufficientBalanceError(Exception):
    """残高不足の際に発生させる例外"""
    def __init__(self, balance, amount):
        self.message = f"残高不足です。現在の残高: {balance}, 必要額: {amount}"
        super().__init__(self.message)

# カスタム例外の使用例
def withdraw(balance, amount):
    if amount > balance:
        raise InsufficientBalanceError(balance, amount)
    return balance - amount

try:
    withdraw(1000, 5000)
except InsufficientBalanceError as e:
    print(e)

実行結果

残高不足です。現在の残高: 1000, 必要額: 5000

独自例外を用いることで、「何が原因でエラーになったのか」をクラス名自体で明示できるようになります。

特に大規模な開発プロジェクトでは、ドメイン（業務）ルールに則った例外を定義することで、エラー処理のロジックが整理されます。

実務におけるraise文のベストプラクティス

raise文は強力なツールですが、使い方を誤るとコードを複雑にしてしまいます。

ここでは、プロフェッショナルな開発者が意識しているポイントを紹介します。

1. 具体的すぎる例外を投げない

広すぎる例外クラス（例：単なるException）をraiseするのは避けるべきです。

Exceptionを投げると、意図しないエラーまでexcept Exception:でキャッチされてしまい、バグの発見が遅れる原因になります。

可能な限り、具体的な例外クラスを選択するか、自作の例外を使用しましょう。

2. 分かりやすいメッセージを添える

raise ValueError()のように中身を空にするのではなく、エラー発生時の状況がわかるメッセージを含めてください。

「値が不正です」よりも「年齢には0から120の数値を指定してください（入力値: -5）」といった具体的な情報の方が、修正の助けになります。

3. 正常な制御フローに例外を使わない

例外処理はあくまで「異常事態」のための仕組みです。

条件分岐（if文）で解決できるような通常の処理フローにおいて、raiseを多用するとパフォーマンスの低下や可読性の悪化を招きます。

「想定される範囲の分岐」はif文で、「想定外の事態」はraiseでという使い分けが重要です。

assert文とraise文の違い

raiseと似た機能にassert（アサーション）があります。

初心者の方はどちらを使うべきか迷うことが多いですが、その役割は明確に異なります。

raise文： プログラムの実行中に発生し得るエラーを処理するために使用する。製品版（本番環境）でも動作させる。
assert文： 開発段階でのデバッグのために、プログラムが前提としている条件をチェックするために使用する。最適化オプション（-O）で無効化される可能性がある。

ユーザーの入力チェックやファイルの存在確認など、本番環境でも必ずチェックが必要な箇所には、必ずraise文を使用してください。

raise文をより高度に活用する手法

最後に、少し発展的なraiseの使い方についても触れておきます。

contextlibを用いたクリーンアップとの併用

raiseで処理を中断する際、開いているファイルやネットワーク接続を確実に閉じなければならない場合があります。

このようなケースでは、with構文やtry...finallyと組み合わせてraiseを使用します。

Python

def write_to_file(filename, content):
    f = open(filename, 'w')
    try:
        if not content:
            raise ValueError("書き込む内容が空です。")
        f.write(content)
    finally:
        # raiseが発生しても、ファイルは確実に閉じられる
        f.close()
        print("リソースを解放しました。")

これにより、エラーが発生してもシステムのリソースリークを防ぐことができます。