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"}
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
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 を使用してアクセス"}
from starlette.middleware.httpsredirect import HTTPSRedirectMiddleware
app = FastAPI()
# HTTPS リダイレクトを強制
app.add_middleware(HTTPSRedirectMiddleware)
@app.get("/")
async def root():
return {"message": "HTTPS を使用してアクセス"}
よく使われる組み込みミドルウェア:
| ミドルウェア | 説明 |
|---|---|
HTTPSRedirectMiddleware | HTTP リクエストを 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 圧縮される可能性があります"}
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 リダイレクトなどの組み込みミドルウェアを提供している