FastAPI ミドルウェア

ミドルウェアは、各リクエストがルート処理関数に到達する前後に実行される関数です。

ミドルウェアは、ログの追加、リクエスト/レスポンスの変更、CORS 処理などの共通ロジックに使用できます。


ミドルウェアの動作原理

ミドルウェアの実行フロー:

  • リクエストがミドルウェアに到達
  • ミドルウェアが前処理ロジックを実行
  • ミドルウェアがリクエストを次のミドルウェアまたはルート関数に渡す
  • ルート関数がレスポンスを返す
  • ミドルウェアが後処理ロジックを実行
  • レスポンスがクライアントに返される

名称 役割
クライアント(Client) ブラウザ、フロントエンドアプリ、Postman などが FastAPI に HTTP リクエストを送信する
Request リクエスト HTTP リクエストオブジェクト。URL、Header、Body、Cookie などのデータを含む
ミドルウェア 1 リクエスト到達後の第 1 層の処理
ミドルウェア 2 第 2 層の処理ロジック
ミドルウェア N 複数のミドルウェアが順番に実行される
ルート処理関数(Path Operation) 実際にビジネスコードを実行する場所
レスポンス段階 ルートが Response を返した後、レスポンスは再びミドルウェアを通過する
ミドルウェアは逆順で返す レスポンスは「逆順」で返される
Response レスポンス 最終的にクライアントに返されるデータ

ミドルウェアの作成

使用する@app.middleware("http")デコレータを使用してミドルウェアを作成:

例

import time
from fastapi import FastAPI, Request

app = FastAPI()


@app.middleware("http")
async def add_process_time_header(request: Request, call_next):
    # 1. リクエスト前の処理:開始時間を記録
    start_time = time.time()

    # 2. リクエストを次のミドルウェアまたはルート関数に渡す
    response = await call_next(request)

    # 3. レスポンス後の処理:処理時間を計算しレスポンスヘッダーを追加
    process_time = time.time() - start_time
    response.headers["X-Process-Time"] = str(process_time)
    return response


@app.get("/")
async def root():
    return {"message": "Hello World"}

コードの説明:

部分説明
@app.middleware("http")これが HTTP ミドルウェアであることを宣言
request: Request現在のリクエストオブジェクト
call_next次のミドルウェアまたはルート関数を呼び出すコールバック
await call_next(request)リクエストを次の層に渡し、レスポンスを取得

call_next受け取りrequestパラメータと返却response。呼び出しのcall_next前にリクエストを変更し、呼び出しの後にレスポンスを変更できます。


リクエストログミドルウェア

次のミドルウェアは各リクエストの基本情報を記録します:

例

import time
import logging
from fastapi import FastAPI, Request

app = FastAPI()

logger = logging.getLogger("uvicorn.access")


@app.middleware("http")
async def log_requests(request: Request, call_next):
    # リクエスト情報を記録
    logger.info(f"リクエスト: {request.method} {request.url}")

    start_time = time.time()
    response = await call_next(request)
    process_time = time.time() - start_time

    # レスポンス情報を記録
    logger.info(
        f"レスポンス: {request.method} {request.url} "
        f"ステータスコード={response.status_code} 処理時間={process_time:.3f}s"
    )

    return response

ミドルウェアの実行順序

ミドルウェアは登録順に実行され、リクエストは正順でミドルウェアを通過し、レスポンスは逆順でミドルウェアを通過します:

请求 -> 中间件A(前) -> 中间件B(前) -> 路由函数
响应 <- 中间件A(后) <- 中间件B(后) <- 路由函数

ミドルウェアの登録順序は重要です。2 つのミドルウェア A と B があり、先に A を登録した場合、リクエストは最初に A を通過してから B を通過しますが、レスポンスは最初に B を通過してから A を通過します。


Starlette 組み込みミドルウェアの使用

FastAPI は Starlette から継承しており、Starlette が提供するミドルウェアを直接使用できます:

例

from fastapi import FastAPI
from starlette.middleware.httpsredirect import HTTPSRedirectMiddleware

app = FastAPI()

# HTTPS リダイレクトを強制
app.add_middleware(HTTPSRedirectMiddleware)


@app.get("/")
async def root():
    return {"message": "HTTPS を使用してアクセス"}

よく使われる組み込みミドルウェア:

ミドルウェア説明
HTTPSRedirectMiddlewareHTTP リクエストを HTTPS に強制的にリダイレクト
TrustedHostMiddlewareアクセスを許可するホスト名を制限
GZipMiddlewareレスポンスコンテンツを自動圧縮
CORSMiddlewareクロスオリジンリクエストを処理(次の章で詳しく説明)

GZip 圧縮ミドルウェア

GZip 圧縮を有効にすると、レスポンスサイズを減らし、転送速度を向上できます:

例

from fastapi import FastAPI
from fastapi.middleware.gzip import GZipMiddleware

app = FastAPI()

# レスポンスサイズが 1000 バイトを超えると自動的に圧縮
app.add_middleware(GZipMiddleware, minimum_size=1000)


@app.get("/")
async def root():
    return {"message": "このレスポンスは GZip 圧縮される可能性があります"}

まとめ

  • ミドルウェアはリクエスト/レスポンスの処理チェーンで共通ロジックを実行する
  • 使用する@app.middleware("http")カスタムミドルウェアを作成
  • call_next(request)リクエストを次の層に渡す
  • ミドルウェアは登録順に実行される(リクエストは正順、レスポンスは逆順)
  • FastAPI/Starlette は CORS、GZip、HTTPS リダイレクトなどの組み込みミドルウェアを提供している
その他の拡張