2026年11月18日、PythonのWebフレームワークFastAPIの0.164.0と0.165.0が、同じ日に公開されました。どちらも、送られてくるデータに上限を設けるための新機能です。
0.164.0では、リクエストの本体、つまりボディの大きさの上限を決めるmax_body_sizeが加わりました。0.165.0では、フォームの項目の数や大きさの上限を変えられるform_limitsが加わっています。
前回の記事で紹介した0.163.0から、わずか4日での更新です。今回は、0.163.0と0.165.0で同じコードを動かしながら、何ができるようになったのかを見ていきます。
まずはリクエストのボディとは¶
最初に、今回の話の前提となる、リクエストのボディについて簡単に紹介します。ブラウザやアプリからWebのサーバーにデータを送るとき、送る中身の部分をボディと呼びます。
たとえば、会員登録のフォームに入力した名前や、アップロードした画像のファイルが、ボディに入って送られます。JSONで送るAPIでも、JSONの文字列がボディです。
なぜ上限が必要なのか¶
ボディの大きさに上限がないと、悪意のある人が、とても大きなデータを送りつけることができます。サーバーがそれを読み込もうとすると、メモリーや時間を使い果たして、ほかの人がアプリを使えなくなるおそれがあります。
0.163.0までは、FastAPI()やルートの引数で、ボディ全体の大きさの上限を決めることはできませんでした。手前に置くNginxなどのサーバーや、ミドルウェアで制限するのが一般的でした。
FastAPIの基本は、こちらで紹介しています。【関連記事】PythonのFastAPIとは?
0.163から0.165で何が変わったのかを整理しよう¶
続いて、今回の範囲の変更を表にまとめます。内容は、FastAPIの公式リポジトリにあるリリースノートにもとづいています。
| 版 | 公開日 | 主な変更 |
|---|---|---|
| 0.163.1 | 11月15日 | 入れ子のcomputed fieldを持つレスポンスのモデルで、OpenAPIの説明が崩れる問題を修正 |
| 0.163.2 | 11月17日 | クエリ、ヘッダー、フォームの値を取り出す処理を整理 |
| 0.164.0 | 11月18日 | リクエストのボディの大きさの上限を設定できるように |
| 0.165.0 | 11月18日 | フォームを読み取るときの上限を設定できるように |
前回取り上げた0.163.0までの流れは、こちらです。【関連記事】FastAPI 0.163がリリース。依存関係の同時実行数を絞れるmax_concurrency
ボディの大きさに上限を設けられるように¶
まずは、0.164.0のmax_body_sizeから見ていきましょう。FastAPIの公式ドキュメントのRequest Body Limitsによると、FastAPI()を作るときに、ボディの上限をバイト単位で指定できます。
さらに、APIRouterや、1つ1つのルートごとに、別の上限を設定することもできます。
試してみた¶
実際に、アプリ全体の上限を1024バイトにし、アップロード用のルートだけ1万バイトまで許してみました。
from fastapi import FastAPI
app = FastAPI(max_body_size=1024)
@app.post("/memo")
async def memo(data: dict):
return {"keys": len(data)}
@app.post("/upload", max_body_size=10_000)
async def upload(data: dict):
return {"keys": len(data)}
httpxを使ってアプリに直接、約100バイトと約2KBのJSONを送った結果です。手元のPython 3.11で、それぞれの版を新しい仮想環境に入れています。
| 送った先 | 約100バイト | 約2KB |
|---|---|---|
| /memo(上限1024バイト) | 200 | 413 Content Too Large |
| /upload(上限1万バイト) | 200 | 200 |
/memoでは、上限を超えた2KBのJSONが、413というステータスコードで断られました。413は、送られてきたデータが大きすぎることを表すコードです。
一方、/uploadでは、ルートに設定した1万バイトの上限が優先され、2KBのJSONも受け付けられました。
0.163.0では使えない¶
同じコードを0.163.0で動かすと、次のエラーになりました。
TypeError: FastAPI.__init__() got an unexpected keyword argument 'max_body_size'
APIRouterに指定した場合も、0.163.0では同じようにTypeErrorでした。黙って無視されるのではなく、すぐにエラーで気づけるので安心です。
上限が決まる順番¶
ドキュメントによると、max_body_sizeは、より細かい場所の設定が優先されます。指定しなかった場所では、外側の設定をそのまま引き継ぎます。
| 設定する場所 | 書き方の例 |
|---|---|
| アプリ全体 | FastAPI(max_body_size=1024 * 1024) |
| ルーター | APIRouter(max_body_size=...)、またはinclude_router()で指定 |
| 1つのルート | @app.post("/upload", max_body_size=...) |
どこにも設定しなければ、これまでどおり上限なしです。0を指定すると、空のボディだけを受け付けます。
ドキュメントでは、ふだんのJSONは小さく制限し、ファイルのアップロード用のルートだけ大きく許す、という使い方が紹介されています。
ルーターに設定してみた¶
実際に、/apiから始まるルートをまとめたAPIRouterに、50バイトという小さな上限を付けてみました。
from fastapi import APIRouter, FastAPI
app = FastAPI()
router = APIRouter(prefix="/api", max_body_size=50)
@router.post("/x")
async def x(data: dict):
return data
app.include_router(router)
アプリ全体には上限を付けていませんが、/api/xに約100バイトのJSONを送ると、413になりました。ルーターにまとめたルートだけに、同じ上限をかけられるので、管理画面用のAPIだけ厳しくする、といった使い方ができます。
数え方の注意¶
ドキュメントによると、上限はボディ全体に対して数えられます。1回のリクエストで複数のファイルを送れば、すべてのファイルと、フォームの項目の合計で比べられます。
また、送る側がContent-Lengthという大きさの申告を付けずに、少しずつ送ってきた場合でも、実際に読んだバイト数で数えるとのことです。URLやヘッダーは、ボディの外なので数えません。
フォームの上限を変えられるように¶
続いて、0.165.0のform_limitsです。HTMLのフォームやファイルのアップロードで送られてきたデータを読み取るときの上限を、変えられるようになりました。
ドキュメントによると、設定できるのは次の3つです。
| 設定 | 意味 | 既定値 |
|---|---|---|
| max_fields | ファイル以外の項目の数 | 1,000 |
| max_files | ファイルの数 | 1,000 |
| max_part_size | ファイル以外の項目1つの大きさ | 1MiB |
これらの上限は、もともと土台のStarletteが持っていたものです。0.165.0からは、FastAPIの側で、アプリやルートごとに変えられるようになりました。
試してみた¶
実際に、アンケートのルートだけ、項目の数を3つまでにしてみました。
from typing import Annotated
from fastapi import FastAPI, Form
app = FastAPI()
@app.post("/survey", form_limits={"max_fields": 3})
async def survey(
a: Annotated[str, Form()] = "",
b: Annotated[str, Form()] = "",
):
return {"ok": True}
2つの項目を送ると200で受け付けられ、5つの項目を送ると400になりました。返ってきたのは、Too many fields. Maximum number of fields is 3.というメッセージです。
max_part_sizeも試しました。上限を10バイトにしたルートに、20文字の項目を送ると、400になりました。
このときのメッセージはPart exceeded maximum size of 0KB.で、1KBに満たない上限は0KBと表示されていました。小さな値を設定したときは、メッセージの数字に惑わされないようにしましょう。
ボディの上限を超えたときは413、フォームの上限を超えたときは400と、返るコードが違う点も覚えておきましょう。
既定の上限はこれまでどおり¶
何も設定しないときの動きも、2つの版で比べました。1001個の項目を送ると、0.163.0でも0.165.0でも、Maximum number of fields is 1000という400になりました。
約2MBの項目を1つ送った場合も、どちらの版でもPart exceeded maximum size of 1024KB.という400でした。既定の上限は変わらず、必要な場所だけ、上限を変えられるようになったわけです。
フォームを読み取るpython-multipartの安全面の修正は、こちらで紹介しました。【関連記事】python-multipart 0.0.33がリリース
ミドルウェアで本体を読むときの注意¶
ドキュメントには、ミドルウェアについての注意も書かれています。ミドルウェアとは、リクエストがルートに届く前や後に、共通の処理を挟む仕組みのことです。
ルートが決まる前に、ミドルウェアでボディを読み込むと、その時点ではアプリ全体の上限が使われます。アップロード用のルートだけ上限を大きくしていても、ミドルウェアで先に断られることがあるわけです。
ミドルウェアでアップロードの中身を読む必要があるなら、アプリ全体の上限を大きめにして、各ルートで小さく絞るよう勧められています。
上げる前にやっておきたいこと¶
最後に、FastAPIを0.165.0へ上げたあとに確かめておきたいことを整理します。
| 順番 | 確認すること |
|---|---|
| 1 | Python 3.11以上を使っているか |
| 2 | ふだんのAPIに、アプリ全体のmax_body_sizeを設定できないか |
| 3 | ファイルのアップロード用のルートに、大きめの上限を個別に設定したか |
| 4 | ボディを読むミドルウェアがあるなら、アプリ全体の上限と合っているか |
私は10年ほどエンジニアとして開発に関わってきましたが、画像のアップロードの機能で、手前のサーバーにだけ上限を設定していて、別の経路からは大きなファイルが送れてしまっていたことがあります。アプリの中でも上限を決めておけるのは、守りを二重にできる良い変更です。
まとめ¶
2026年11月18日、FastAPI 0.164.0と0.165.0が公開されました。max_body_sizeでリクエストのボディの大きさに、form_limitsでフォームの項目の数や大きさに、上限を設けられるようになっています。
アプリ、ルーター、ルートごとに上限を変えられるので、アップロードのルートだけ大きく許す、といった使い分けができます。公開しているAPIがある方は、この機会に上限を決めておいてはいかがでしょうか。
ここまでお読みいただきありがとうございました。