Pythonで例外を発生させる方法｜raise文の使い方と例外処理の基本

try…exceptで例外を捕捉して処理を継続

def risky_function(): raise RuntimeError("予期しないエラー")

logging.basicConfig(level=logging.ERROR)

class AgeValidationError(ValidationError): """年齢バリデーション専用の例外""" def init(self, age, message="年齢が不正です"): self.age = age self.message = f"{message}（入力値: {age}）" super().init(self.message)

実行例

def __str__(self):
    return self.message

使用例

try: raise APIError(404, "/api/users", "リソースが見つかりません") except APIError as e: print(e) print(f"ステータスコード: {e.status_code}")

出力：リソースが見つかりません | ステータス: 404 | エンドポイント: /api/users

raiseを使う上での注意点

過剰にraiseを使いすぎない

注意：すべての処理にraiseを使うとコードが複雑になります。Noneを返すだけで十分な場合や、デフォルト値で対応できる場合は例外を使わない選択も重要です。raiseは「本当に異常な状態」を表現するために使います。

例外の適切な階層設計

カスタム例外を作りすぎると管理が難しくなります。基底クラスとなる例外（例：AppError）を定義し、その下に用途別の例外を継承させる階層構造にすることで、まとめて捕捉したり個別に処理したりが柔軟にできます。

# 良い設計例 class AppError(Exception): pass # アプリ全体の基底例外 class DatabaseError(AppError): pass # DB関連エラー class NetworkError(AppError): pass # ネットワーク関連エラー class ValidationError(AppError): pass # バリデーションエラー

ユーザーやシステムへの影響を考慮

例外が止める処理とログ出力のバランス

例外を発生させると処理が中断されます。ユーザー向けのアプリケーションでは、例外をそのまま表示するのではなく、分かりやすいエラーメッセージに変換して提示することを忘れないようにしてください。

標準例外とカスタム例外の使い分け

型の不一致にはTypeError、値の不正にはValueErrorなど、Pythonの標準例外で十分に表現できる場合は標準例外を使います。アプリケーション固有のビジネスルール違反や、複数の情報を持たせたい場合にカスタム例外を使うのが適切な設計です。

実践例

関数の入力値検証での例外発生

def create_user(username: str, email: str, age: int) -> dict: """ユーザー作成関数""" # 型チェック if not isinstance(username, str): raise TypeError(f"usernameは文字列が必要です: {type(username)}") if not isinstance(age, int): raise TypeError(f"ageは整数が必要です: {type(age)}")

# 値のバリデーション
if len(username) < 3:
    raise ValueError("ユーザー名は3文字以上必要です")
if "@" not in email:
    raise ValueError("メールアドレスの形式が不正です")
if age < 18:
    raise ValueError("18歳未満は登録できません")

return {"username": username, "email": email, "age": age}

try: user = create_user("ab", "invalid-email", 15) except (TypeError, ValueError) as e: print(f"ユーザー作成エラー: {e}")

ファイル操作時のエラー処理

import os

if not filepath.endswith(".json"):
    raise FileProcessError(f"JSONファイルのみ対応しています: {filepath}")

try:
    with open(filepath, "r", encoding="utf-8") as f:
        return f.read()
except PermissionError:
    raise FileProcessError(f"ファイルの読み取り権限がありません: {filepath}")

try: content = read_config_file("config.txt") except FileNotFoundError as e: print(f"ファイルエラー: {e}") except FileProcessError as e: print(f"処理エラー: {e}")

WebアプリやAPIでのraise活用

フォーム入力チェック

class FormValidationError(Exception): """フォームバリデーションエラー""" def init(self, field, message): self.field = field self.message = message super().init(f"{field}: {message}")

for field in required_fields:
    if field not in form_data or not form_data[field]:
        raise FormValidationError(field, "この項目は必須です")

if len(form_data["password"]) < 8:
    raise FormValidationError("password", "パスワードは8文字以上必要です")

return True

try: validate_registration_form({"username": "Taro", "email": "[email protected]", "password": "abc"}) except FormValidationError as e: print(f"フォームエラー [{e.field}]: {e.message}")

APIレスポンスの検証と例外処理

class APIResponseError(Exception): """APIレスポンスエラー""" def init(self, status_code, message): self.status_code = status_code super().init(f"HTTPステータス {status_code}: {message}")

status = response["status_code"]

if status == 200:
    return response.get("data")
elif status == 401:
    raise APIResponseError(401, "認証が必要です")
elif status == 404:
    raise APIResponseError(404, "リソースが見つかりません")
elif status >= 500:
    raise APIResponseError(status, "サーバーエラーが発生しました")
else:
    raise APIResponseError(status, "予期しないステータスコードです")

try: data = parse_api_response({"status_code": 404, "data": None}) except APIResponseError as e: print(f"APIエラー: {e}") print(f"ステータスコード: {e.status_code}")

Pythonのraiseとエラーハンドリングの詳しい解説については、IT Biz「Pythonのraise文完全ガイド」、ITさくら「Pythonのtry except例外処理の使い方」、@IT「Pythonの例外処理とraiseの実践的な使い方」も参考にしてください。

Pythonをはじめとするプログラミングの実践的な解説は、kakiro-web.comでも幅広く公開しています。

まとめ

raiseはPythonで例外を発生させる基本手段

raise文はPythonで意図的に例外を発生させるための基本的な構文です。raise ExceptionClass("メッセージ")という形で使い、型・値・状態などが不正な場合にプログラムの異常を明示的に通知できます。

try…exceptと組み合わせることで安全な処理分岐が可能

raiseで発生させた例外をtry…exceptで捕捉することで、エラーの種類に応じた処理分岐が実現できます。as eで例外情報を取得し、tracebackモジュールやloggingと組み合わせることでデバッグ・ログ記録への応用も可能です。

標準例外やカスタム例外を適切に使い分けて、デバッグやエラー管理に活用

型エラーにはTypeError、値の不正にはValueErrorなど標準例外を活用し、アプリケーション固有のルール違反にはカスタム例外を定義することで、読みやすく保守しやすいエラーハンドリングが実現できます。

• 基本構文はraise ExceptionClass("メッセージ")
• 状況に合った標準例外クラスを選ぶとコードの意図が伝わりやすい
• try…exceptと組み合わせてエラーを捕捉・制御する
• 引数なしのraiseで捕捉した例外を再発生させられる
• カスタム例外はExceptionを継承して定義する
• アプリ全体で基底例外クラスを設計すると管理しやすくなる
• raiseの使いすぎを避け「本当に異常な状態」にのみ使う