Flask リクエストライフサイクル

Flask リクエストの完全なライフサイクルを理解することは、Flask アプリケーションを上手に書くための鍵です。

この章では、ソースコードレベルで HTTP リクエストがサーバーに入ってからレスポンスを返すまでの全プロセスを分解し、明確な実行モデルを構築するのに役立ちます。


リクエストライフサイクルとは

リクエストライフサイクル(Request Lifecycle)とは、HTTP リクエストが Flask 内部で経る一連の処理プロセスのことです。

以下の段階が含まれます:リクエスト受信 → コンテキスト作成 → 前処理 → ルーティング → ビュー実行 → レスポンス構築 → コンテキスト解放 → レスポンス返却。

このプロセスを理解すれば、以下の質問に正しく答えられるようになります:

  • gオブジェクトのデータはいつ利用可能になり、いつクリーンアップされるのか?
  • before_requestとafter_requestの実行順序は?
  • 例外発生時にはどの処理ステップを順に経るのか?
  • なぜビュー関数の外で を使用するとrequestエラーになるのか?

全体フローチャート

次の図は、Flask がリクエストを受信してからレスポンスを返すまでの完全な呼び出しチェーンを示しています:

Flask 请求处理生命周期

ステップごとの詳細解説

第1段階:WSGI エントリポイント

HTTP リクエストがサーバーに到達すると、WSGI サーバー(Gunicorn、Werkzeug 開発サーバーなど)が Flask アプリケーションインスタンスを呼び出します。

Flask は を実装しており、__call__メソッドを実装し、正当な WSGI アプリケーションになっています:

例

# Flask ソースコード簡略版(実際の場所:flask/app.py)
# WSGI サーバーは次のようにアプリケーションを呼び出します:
# response = app(environ, start_response)

class Flask(App):
    def __call__(self, environ, start_response):
        """WSGI サーバーが呼び出すエントリポイント"""
        return self.wsgi_app(environ, start_response)

    def wsgi_app(self, environ, start_response):
        """実際の WSGI 処理ロジック"""
        # ステップ1:environ からリクエストコンテキストを作成
        ctx = self.request_context(environ)
        try:
            ctx.push()                    # コンテキストスタックにプッシュ
            response = self.full_dispatch_request(ctx)  # 完全なディスパッチ
        except Exception as e:
            response = self.handle_exception(ctx, e)    # 例外のフォールバック
        finally:
            ctx.pop(error)               # コンテキストをポップしてクリーンアップを実行
        return response(environ, start_response)

Flask はエントリポイントを の呼び出しとして設計し、wsgi_appメソッドを使用します(直接 で__call__ロジックを書くのではありません。これにより、 を置き換えることでapp.wsgi_appミドルウェアを挿入でき、 へのappインスタンス自体の呼び出しには影響しません。

第2段階:コンテキストの作成

request_context(environ)WSGI 環境変数に基づいて を作成します。AppContextオブジェクト。

このオブジェクトには現在のリクエストのすべての情報が含まれており、スタックにプッシュされると、request、session、g、current_appこれらのグローバルプロキシが現在のリクエストのデータを指し始めます。

例

# コンテキストを理解するための簡単な実験
from flask import Flask, request, current_app

app = Flask(__name__)

with app.app_context():
    # アプリケーションコンテキストのみ——current_app は利用可能、request は利用不可
    print(current_app.name)  # ✓ 正常
    # print(request.method) # ✗ エラー:Working outside of request context

with app.test_request_context("/hello?name=サンプル"):
    # リクエストコンテキストにはアプリケーションコンテキストも含まれる——両方利用可能
    print(current_app.name)     # ✓ アプリ名を出力
    print(request.path)         # ✓ /hello を出力
    print(request.args["name"]) # ✓ サンプル を出力
コンテキストの種類 作成タイミング 破棄タイミング 利用可能なグローバル変数
アプリケーションコンテキスト リクエスト到達時 / 手動 with app.app_context() リクエスト終了 / with ブロック終了 current_app, g
リクエストコンテキスト リクエスト到達時 / 手動 with app.test_request_context() リクエスト終了 / with ブロック終了 request, session(アプリケーションコンテキストのすべての変数を含む)

初心者が最も犯しやすい間違いは、モジュールレベルで直接 にアクセスすることです。request。覚えておいてください:requestはリクエストコンテキスト内でのみ存在します。ビュー関数の内部(またはそこで呼び出される関数)でのみアクセスできます。

第3段階:preprocess_request(前処理)

コンテキストが準備完了すると、full_dispatch_request最初に を呼び出します。preprocess_request。

この段階では、 を使用して@app.before_request登録されたすべての関数を実行します。

いずれかのbefore_request関数が 以外のNone値を返した場合、Flask はそれを最終レスポンスとみなし、後続のビュー関数の実行をスキップします。

例

from flask import Flask, request, session, redirect, url_for

app = Flask(__name__)
app.secret_key = "dev-secret"

@app.before_request
def check_authentication():
    """各リクエストの前にユーザーがログインしているか確認"""
    # ログイン・登録ページの認証チェックをスキップ
    if request.endpoint in ("login", "register", "static"):
        return None  # None は通常フローを継続することを示す

    # 未ログインの場合、リダイレクトレスポンスを直接返す(ビュー関数をスキップ)
    if "username" not in session:
        return redirect(url_for("login"))

    # ユーザーがログイン済みのため、正常に続行
    return None

@app.route("/login", methods=["GET", "POST"])
def login():
    if request.method == "POST":
        session["username"] = request.form["username"]
        return redirect(url_for("dashboard"))
    return '<form method="post"><input name="username"><input type="submit"></form>'

@app.route("/register")
def register():
    return "登録ページ(ログイン不要)"

@app.route("/dashboard")
def dashboard():
    return f"ようこそ {session['username']}、サンプル コンソールへ"

第4段階:dispatch_request(ルーティング)

前処理が完了すると、Flask はコアとなるディスパッチ段階に入ります:

  1. URL を対応するルーティングルールにマッチング(Rule)
  2. URL 内の変数パラメータを抽出(view_args)
  3. 抽出したパラメータを渡して対応するビュー関数を呼び出します

例

# ソースコード簡略版:dispatch_request の処理フロー
def dispatch_request(self, ctx):
    req = ctx.request
    # マッチしたルーティングルール(Rule オブジェクト)を取得
    rule = req.url_rule
    # URL 内の変数パラメータを取得。例:/post/42 → {"post_id": 42}
    view_args = req.view_args
    # view_functions ディクショナリから対応する関数を見つけて呼び出す
    return self.view_functions[rule.endpoint](**view_args)

マッチングに失敗すると がスローされ、RoutingException、最終的にエラーハンドラによって捕捉され、404 が返されます。

第5段階:ビュー関数の実行

ここがビジネスロジックを書く場所です。Flask はビュー関数を呼び出し、戻り値を取得します。

戻り値は文字列、辞書、タプル、Response オブジェクトなど複数の型を取ることができ、これらはすべて次の段階で統一的に処理されます。

第6段階:finalize_request(レスポンス構築)

ビュー関数の実行が完了すると、finalize_requestは戻り値を標準の に変換します:Responseオブジェクト:

例

# ソースコード簡略版:finalize_request の処理フロー
def finalize_request(self, ctx, rv):
    # 1. make_response を呼び出して、さまざまな型の戻り値を Response オブジェクトに変換
    response = self.make_response(rv)

    # 2. process_response を介して after_request フックを実行
    response = self.process_response(ctx, response)

    # 3. シグナルを送信:request_finished
    request_finished.send(self, response=response)

    return response

make_responseの変換ルール:

戻り値の型 変換方法
str / bytes レスポンスボディとして使用、Content-Type: text/html
dict / list jsonify() を呼び出し、Content-Type: application/json
tuple (body, status) または (body, headers) として解析
Response オブジェクト そのまま使用
iterator / generator ストリーミングレスポンスとして

第7段階:after_request フック

process_responseを実行した後、make_responseすべての を順に呼び出します。@app.after_request登録された関数。

各after_request関数は を受け取り、返します。Responseオブジェクト。レスポンスヘッダーの変更、Cookie の追加などができます。

例

# after_request の典型的な使い方:各レスポンスにセキュリティヘッダーを追加する
@app.after_request
def add_security_headers(response):
    response.headers["X-Content-Type-Options"] = "nosniff"
    response.headers["X-Frame-Options"] = "DENY"
    response.headers["X-XSS-Protection"] = "1; mode=block"
    return response  # response オブジェクトを返す必要がある

# CORS ヘッダーの追加にもよく使われる
@app.after_request
def add_cors_headers(response):
    response.headers["Access-Control-Allow-Origin"] = "*"
    response.headers["Access-Control-Allow-Methods"] = "GET, POST, PUT, DELETE"
    return response

第8段階:コンテキストのクリーンアップ

レスポンス送信後、finallyブロック内のctx.pop()コンテキストのクリーンアップを実行します:

  1. すべての ... を呼び出しteardown_request登録済み関数(リクエストの成功・失敗にかかわらず実行されます)
  2. すべての ... を呼び出しteardown_appcontext登録済み関数
  3. ... を送信request_tearing_downとappcontext_tearing_downシグナル
  4. ... を解放gオブジェクトに保存されているすべてのデータ

例

# teardown の典型的な使い方:データベース接続を閉じる
@app.teardown_appcontext
def close_database_connection(error):
    """リクエストでエラーが発生しても、データベース接続が確実に閉じられるようにする"""
    db = g.pop("db", None)
    if db is not None:
        db.close()
    # error パラメータ:リクエスト処理中に例外が発生した場合、ここで受け取ります
    if error:
        app.logger.warning(f"リクエスト例外が発生しました。データベース接続を閉じました: {error}")

# teardown と after_request の違い
@app.after_request
def after(response):
    # after_request は通常のフローで実行され、例外時には実行されない
    # 成功したレスポンスの変更に使用する
    return response

@app.teardown_request
def teardown(error):
    # teardown は常に実行される——リクエストの成功・失敗にかかわらず
    # リソースのクリーンアップに使用する(ファイルを閉じる、ロックを解放するなど)
    pass

例外処理フロー

ビュー関数が例外をスローすると、Flask には専用の例外処理パスがあります:

  1. full_dispatch_request例外をキャッチ
  2. ... を呼び出しhandle_user_exception例外のタイプを判定
  3. HTTP 例外(例:abort(404))→ 対応する ... を検索errorhandler
  4. 通常の例外 → 例外クラスの ... を検索errorhandler
  5. ハンドラーが見つからない → ... を呼び出しhandle_exception、500 エラーを返す
  6. 例外の有無にかかわらず、最終的に ... を経由しますfinalize_requestレスポンスの構築

例外パスの重要なポイント:after_requestフックはエラーレスポンスに対しても実行されます(Flask 1.1 以降)が、before_request返された非 None 値はフロー全体をショートサーキットし、後続のビュー関数とフックは実行されません。


フック関数クイックリファレンス

フック 登録方法 実行タイミング 典型的な用途
before_request @app.before_request ルートディスパッチ前 ログインチェック、リクエストログ、権限検証
before_first_request @app.before_request(非推奨) 最初のリクエスト前(1回のみ) 初期化操作(ファクトリーパターンへの変更を推奨)
after_request @app.after_request レスポンス構築後、送信前 レスポンスヘッダー、CORS、ログの追加
teardown_request @app.teardown_request リクエストコンテキストがポップされる時(常に実行) リソースの解放、ファイルを閉じる
teardown_appcontext @app.teardown_appcontext アプリケーションコンテキストがポップされる時(常に実行) データベース接続のクローズ、キャッシュのクリーンアップ
errorhandler @app.errorhandler(code) 対応するエラーコード/例外が発生した時 カスタムエラーページ

シグナルイベント

Flask は ... を使用しますblinkerライブラリが重要なポイントでシグナルを送信します:

例

from flask import Flask, signals

app = Flask(__name__)

# シグナルに接続——リクエスト到着時に記録
@signals.request_started.connect_via(app)
def log_request_start(sender, **extra):
    print("リクエスト開始")

# シグナルに接続——リクエスト完了時に記録
@signals.request_finished.connect_via(app)
def log_request_end(sender, response, **extra):
    print(fリクエスト終了、レスポンスステータスコード: {response.status_code})

# シグナルに接続——例外をキャッチ
@signals.got_request_exception.connect_via(app)
def log_exception(sender, exception, **extra):
    print(f"リクエスト中に例外が発生しました: {exception}")
シグナル トリガータイミング
request_started リクエストコンテキスト確立後、前処理前
request_finished レスポンス構築完了後、送信前
got_request_exception リクエスト処理中に例外が発生した時
request_tearing_down リクエストコンテキストが破棄される時
appcontext_pushed アプリケーションコンテキストがスタックにプッシュされる時
appcontext_popped アプリケーションコンテキストがスタックからポップされる時
message_flashed flash() が呼び出された時
template_rendered テンプレートのレンダリングが成功した時

重要ポイントのまとめ

核心ルール:完全なリクエストライフサイクルにおいて、before_request → ビュー関数 → after_request → teardownこれら4つのノードは必ず順番に実行されます(teardown は常に実行され、最初の3つでエラーが発生しても関係ありません)。

リクエストライフサイクルを理解すると、Flask アプリを書くときに分かるようになります:認証ロジックは ... に置き、before_request、ビジネスロジックはビュー関数に、レスポンスヘッダーの変更は ... に置き、after_request、リソースのクリーンアップは ... に置くteardown。

その他の拡張