18 ноября вышли FastAPI 0.164.0 и 0.165.0, и обе версии про одно и то же: как не дать клиенту прислать слишком большой запрос. В 0.164 появился параметр max_body_size, то есть предельный размер тела запроса в байтах. Его можно задать для всего приложения, для роутера или для отдельного маршрута. В 0.165 к нему добавились лимиты на разбор форм: сколько полей и файлов можно прислать и насколько длинным может быть одно текстовое поле.
Раньше размер запроса обычно ограничивали снаружи, например директивой client_max_body_size в nginx, или писали своё промежуточное ПО (middleware). Теперь это делается в самом приложении, причём для разных маршрутов можно поставить разные значения: небольшой лимит для JSON API и большой для загрузки файлов.

Как задать max_body_size
В документации лимит показывают на таком примере:
from fastapi import APIRouter, FastAPI, UploadFile
app = FastAPI(max_body_size=1 * 1024 * 1024)
uploads = APIRouter(prefix="/uploads", max_body_size=100 * 1024 * 1024)
@app.post("/items")
def create_item(item: dict):
return item
@uploads.post("/")
def upload(file: UploadFile):
return {"filename": file.filename, "size": file.size}
@uploads.post("/small", max_body_size=10 * 1024 * 1024)
def small_upload(file: UploadFile):
return {"filename": file.filename, "size": file.size}
app.include_router(uploads)
POST /itemsработает с общим лимитом приложения в 1 МиБ;POST /uploads/берёт лимит роутера, 100 МиБ;POST /uploads/smallзадаёт свой лимит, 10 МиБ.
Если у маршрута лимит не указан, он берёт его у своего роутера или у приложения. Смонтированные приложения так же наследуют лимит родителя, а для подключаемого роутера значение можно передать прямо в include_router(). Если лимит не задан нигде, размер тела не ограничен, как и раньше, так что после обновления без настройки ничего не изменится. Значение 0 разрешает только пустое тело.

Что считается в лимит
Лимит относится ко всему телу запроса. Если в одном запросе пришли два файла и несколько полей формы, всё это вместе со служебной разметкой multipart попадает в один общий счёт. URL и заголовки в него не входят.
FastAPI считает байты прямо во время чтения, поэтому лимит работает и тогда, когда клиент шлёт тело частями без заголовка Content-Length. Как только лимит превышен, фреймворк перестаёт читать и отвечает 413 Content Too Large, если ответ ещё не начал уходить клиенту. Файлы UploadFile, которые по мере роста переезжают из памяти на диск, тоже считаются.
Есть тонкость для обработчиков, которые читают тело сами. Такой код может начать работу раньше, чем FastAPI узнает итоговый размер. Поэтому, если вы, например, пишете загрузку потоком во временный файл, сначала дочитайте её до конца и только потом выкладывайте файл.

Осторожно с middleware, которое читает тело
Если middleware читает тело раньше, чем FastAPI выбрал маршрут, на это чтение действует лимит приложения. В примере выше middleware с await request.body() отклонит загрузку на 2 МиБ ещё до того, как запрос дойдёт до роутера с лимитом в 100 МиБ. Поэтому при таком middleware лимит приложения стоит ставить с запасом под самые большие загрузки, а маленькие лимиты назначать отдельным маршрутам.
Лимиты для форм в 0.165
Второй новый параметр, form_limits, отвечает за разбор форм в параметрах Form, File и UploadFile, в том числе внутри зависимостей. Настроек три, и каждую можно переопределить по отдельности для приложения, роутера, include_router() или маршрута:
max_fields: сколько текстовых полей может быть в форме, по умолчанию 1000;max_files: сколько файлов можно прислать в multipart-форме, по умолчанию 1000;max_part_size: предельный размер одного текстового поля в байтах, по умолчанию 1 МиБ. В обычных URL-encoded формах учитываются имя и значение поля вместе.
from typing import Annotated
from fastapi import FastAPI, Form
app = FastAPI(form_limits={"max_fields": 5})
@app.post("/notes")
async def create_note(text: Annotated[str, Form()]):
return {"size": len(text)}
@app.post("/documents", form_limits={"max_part_size": 2 * 1024 * 1024})
async def create_document(text: Annotated[str, Form()]):
return {"size": len(text)}
Значения по умолчанию совпадают с теми, что Starlette и раньше применял при разборе форм, просто теперь их можно менять без своего кода. Если форма выходит за эти пределы, клиент получает ответ 400. Размер самих файлов form_limits не ограничивает, для этого нужен max_body_size. А если вы разбираете форму вручную, лимиты передаются в первый вызов request.form(): Starlette запоминает разобранную форму и при повторном вызове отдаёт её же.
form_limits, и каждое значение можно поменять отдельно, не трогая остальные. Источник: fastapi.tiangolo.com, Set limits for form fields and files.Что учесть при обновлении
Ограничение размера тела FastAPI берёт из Starlette, где такой механизм появился в версии 1.6.0. Поэтому начиная с 0.164 FastAPI требует starlette>=1.6.0, раньше хватало 0.46. Обычно pip и uv сами подтянут нужный Starlette, но если его версия закреплена в requirements или lock-файле, её придётся поднять. Python нужен 3.11 или новее, как и с версии 0.162.6, подробнее об этом в заметке про FastAPI 0.163.
python -c "import fastapi, starlette; print(fastapi.__version__, starlette.__version__)" # pip pip install -U "fastapi>=0.165.0" # uv uv add "fastapi>=0.165.0"
Если коротко, новые параметры ничего не меняют сами по себе, но закрывают давний пробел: теперь API на FastAPI можно защитить от огромных запросов и форм с тысячами полей без nginx и своих middleware. Особенно это пригодится там, где приложение смотрит в интернет напрямую или где одни маршруты принимают файлы, а другие только короткий JSON. Если nginx перед приложением уже стоит, его лимит никуда не девается, и разумно держать его чуть больше самого крупного лимита в приложении.