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

接口级配置可覆盖路由和应用继承的上限。
为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把内容转到磁盘也不会让这些字节从计数中消失。

框架按实际读取量计数,无Content-Length也需遵守限制。
先完成读取,再提交外部结果
自行流式读取请求体的接口可能在总量尚未知晓时开始执行。如果向临时文件写入上传内容,先完整读取和验证,再把文件发布到正式位置;不要在超限前就提交不可撤销的外部结果。响应已经开始时也不能假定一定还能切换成413。
检查是否有中间件提前调用request.body():它可能在选择上传路由之前按应用1 MiB上限拒绝请求。确需提前读取大文件时,应用上限要覆盖该需求,再在小接口收窄。反向代理自己的限制仍独立存在;若收到其他层返回的错误,先核对日志和响应来源,不反复放大应用额度掩盖原因。



















