Откройте страницу, если запрос содержит multipart-форму с одним или несколькими файлами. Пример измеряет синтетические файлы и не сохраняет пользовательские данные.
| Задача | Приём | Пример |
|---|---|---|
| Принять форму | Form |
Полный uploads.py |
| Ограничить прочитанный файл | UploadFile.read порциями |
Полный uploads.py · Карточка |
| Проверить размер и отказ | Синтетические bytes и ответ 413 | Полные тесты |
Карточки HTTP · Справочник FastAPI · Проверки
Уровень: средний.
Используйте Python 3.14.
В отдельном окружении выполните python -m pip install 'fastapi==0.162.0' 'uvicorn[standard]' 'python-multipart==0.0.33'.
Сохраните самостоятельный пример в файле uploads.py:
uvicorn uploads:app --reloadДля проверки загрузите существующий учебный файл.
@ в curl означает чтение локального файла:
curl -F 'username=alice' http://127.0.0.1:8000/form
curl -F 'file=@uploads.py' http://127.0.0.1:8000/upload
curl -F 'files=@uploads.py' -F 'files=@uploads.py' http://127.0.0.1:8000/uploadsПервый результат содержит имя из формы. Второй результат содержит имя и размер файла. Третий результат содержит список из двух результатов. Ограничение в обработчике проверяет прочитанное содержимое одного файла. Это ограничение не проверяет полный размер HTTP-запроса до multipart-парсинга. Задайте общий лимит тела также на сервере или прокси. Задайте лимит числа файлов также на сервере или прокси. Имя и MIME-тип присылает клиент. Пример не сохраняет файлы. Пример не проверяет фактический формат файлов. JSON body и multipart body — разные форматы одного запроса.
Источники: файлы, формы и файлы.