FastAPI按路由限制上传请求大小,校验413与流式读取边界

老丽吖_9388

老丽吖_9388

2026-11-19

176人浏览

原创

fastapi 0.164.0及以后支持max_body_size,可给普通json请求设置较小上限,再为上传路由单独提高额度。限制按整份请求体计数,多个文件和表单编码开销都会占用额度。先核对项目安装版本,再配置应用、路由与具体接口,并用实际请求确认正常响应和413两条路径。

FastAPI官方按应用和路由设置请求体上限的示例

接口级配置可覆盖路由和应用继承的上限。

为JSON与上传保留不同额度

from fastapi import APIRouter, FastAPI, UploadFile

app = FastAPI(max_body_size=1 * 1024 * 1024)
uploads = APIRouter(prefix="/uploads", max_body_size=10 * 1024 * 1024)

@app.post("/items")
async def create_item(item: dict):
    return item

@uploads.post("/")
async def upload(file: UploadFile):
    return {"filename": file.filename, "size": file.size}

@uploads.post("/small", max_body_size=2 * 1024 * 1024)
async def small_upload(file: UploadFile):
    return {"filename": file.filename, "size": file.size}

app.include_router(uploads)

将代码保存为main.py,在项目原虚拟环境中检查fastapi版本,安装该项目所需的标准服务器依赖和python-multipart,再用项目原启动方式运行。三个入口分别允许1 MiB、10 MiB和2 MiB请求体。这些是应用选择的示例额度,不是框架默认限制。

用大小明确的文件验证

curl -i -F "file=@sample.bin" http://127.0.0.1:8000/uploads/small

先用明显小于2 MiB的文件验证成功,再用大于2 MiB的文件验证413。multipart边界和字段也计入总量,因此“恰好2 MiB的文件”不适合验证边界内成功;如同时上传多个文件,应按整个请求之和判断。UploadFile把内容转到磁盘也不会让这些字节从计数中消失。

FastAPI官方对分块请求、413和中间件读取的说明

框架按实际读取量计数,无Content-Length也需遵守限制。

先完成读取,再提交外部结果

自行流式读取请求体的接口可能在总量尚未知晓时开始执行。如果向临时文件写入上传内容,先完整读取和验证,再把文件发布到正式位置;不要在超限前就提交不可撤销的外部结果。响应已经开始时也不能假定一定还能切换成413。

fastapi-pro
fastapi-pro

使用 FastAPI、SQLAlchemy 2.0 和 Pydantic V2 构建高性能异步 API。精通微服务、WebSocket 和现代 Python 异

下载

检查是否有中间件提前调用request.body():它可能在选择上传路由之前按应用1 MiB上限拒绝请求。确需提前读取大文件时,应用上限要覆盖该需求,再在小接口收窄。反向代理自己的限制仍独立存在;若收到其他层返回的错误,先核对日志和响应来源,不反复放大应用额度掩盖原因。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

路由优化大师
路由优化大师

路由优化大师是一款及简单的路由器设置管理软件,其主要功能是一键设置优化路由、屏广告、防蹭网、路由器全面检测及高级设置等,有需要的小伙伴快来保存下载体验吧!

下载

相关标签:

fastapi 路由

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Python FastAPI异步API开发_Python怎么用FastAPI构建异步API
Python FastAPI异步API开发_Python怎么用FastAPI构建异步API

Python FastAPI 异步开发利用 async/await 关键字,通过定义异步视图函数、使用异步数据库库 (如 databases)、异步 HTTP 客户端 (如 httpx),并结合后台任务队列(如 Celery)和异步依赖项,实现高效的 I/O 密集型 API,显著提升吞吐量和响应速度,尤其适用于处理数据库查询、网络请求等耗时操作,无需阻塞主线程。

2025.12.22

119

5

Python 微服务架构与 FastAPI 框架
Python 微服务架构与 FastAPI 框架

本专题系统讲解 Python 微服务架构设计与 FastAPI 框架应用,涵盖 FastAPI 的快速开发、路由与依赖注入、数据模型验证、API 文档自动生成、OAuth2 与 JWT 身份验证、异步支持、部署与扩展等。通过实际案例,帮助学习者掌握 使用 FastAPI 构建高效、可扩展的微服务应用,提高服务响应速度与系统可维护性。

2026.02.06

594

18

Python Web框架FastAPI 全栈开发教程合集
Python Web框架FastAPI 全栈开发教程合集

以 FastAPI 为核心,讲解现代 Python Web API 的高效开发方式,涵盖路由定义与路径参数/查询参数/请求体绑定、Pydantic 模型的数据校验与序列化、依赖注入(Depends)系统的分层设计、中间件与 CORS 配置、OAuth2 + JWT 认证流程、后台任务(BackgroundTasks)、WebSocket 实时通信、SQLAlchemy 异步 ORM 集成、自动生成 OpenAPI/Swagger 交互文

2026.05.09

796

23

Python FastAPI异步微服务与高性能接口设计
Python FastAPI异步微服务与高性能接口设计

本专题聚焦 Python FastAPI 框架在高性能接口与微服务开发中的应用,讲解异步请求处理、依赖注入机制、路由设计、数据库异步操作以及接口性能优化策略。结合实际项目案例,帮助开发者构建高并发、低延迟的现代化后端服务架构。

2026.06.16

679

12

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程