Ngày 18/11/2026, FastAPI phát hành hai bản 0.164.0 và 0.165.0, thêm giới hạn kích thước request body và form. Bạn đặt giới hạn toàn cục bằng max_body_size ở cấp app, hoặc riêng cho từng router và endpoint; vượt giới hạn thì nhận lỗi 413. Bản 0.165.0 thêm giới hạn cho form, mặc định tối đa 1.000 field, 1.000 file và 1 MiB cho mỗi field text.
Trước đây, chặn client gửi body vài trăm MB phải tự viết middleware hoặc cấu hình ở reverse proxy, mà proxy chỉ đặt được một mức chung cho cả app.
Giới hạn toàn bộ body với max_body_size
Tham số mới max_body_size (byte) đặt được ở bốn cấp: FastAPI(), APIRouter, include_router() và từng path operation.
from fastapi import APIRouter, FastAPI, UploadFileapp = 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 tối đa 1 MiB, POST /uploads/ tới 100 MiB, POST /uploads/small 10 MiB. Mặc định max_body_size là None — kế thừa từ router hoặc app chứa nó; không đặt ở đâu thì body không bị giới hạn, đặt 0 thì chỉ cho phép body rỗng.
Giới hạn tính trên toàn bộ body: file, field form và byte mã hóa multipart trong cùng một request đều cộng dồn, URL và header không tính. FastAPI đếm số byte nó đọc, kể cả body chunked không có Content-Length, và trả lỗi 413 khi vượt nếu response chưa bắt đầu.
Lưu ý: nội dung file UploadFile vẫn tính vào giới hạn dù file đã chuyển từ RAM xuống đĩa. Middleware đọc body trước chịu giới hạn của app, nên nếu middleware cần đọc upload lớn thì đặt giới hạn app đủ lớn rồi siết nhỏ ở từng endpoint.
Giới hạn form với form_limits
Bản 0.165.0 bổ sung form_limits, một dict đặt được ở app, router, include_router() hoặc từng path operation.
- max_fields: tối đa số field text trong form, mặc định 1.000.
- max_files: tối đa số file trong một form multipart, mặc định 1.000.
- max_part_size: tối đa mỗi field text (mặc định 1 MiB); với form URL-encoded, Starlette cộng cả tên và giá trị.
FastAPI chuyển các giá trị này cho Starlette khi parse request có tham số Form, File hoặc UploadFile, kể cả trong dependency; vượt giới hạn của parser, client nhận lỗi 400. Lưu ý: form_limits chỉ chặn số lượng và kích thước từng field text, muốn chặn tổng dung lượng file upload thì phải dùng max_body_size.
Nâng cấp thế nào
Chạy pip install -U fastapi để lên 0.165.0; từ 0.162.6, FastAPI cần Python 3.11 trở lên (đã bỏ 3.10).
Điều này có ý nghĩa gì với bạn
Endpoint upload file là “cửa hậu” cho tấn công làm cạn RAM hoặc ổ đĩa: vài request body khổng lồ là đủ làm server nghẽn. Đặt giới hạn mặc định nhỏ ở app (ví dụ 1–2 MiB cho API JSON) rồi nới riêng cho endpoint upload. Giới hạn ở tầng app bảo vệ cả khi chạy không qua proxy và tinh chỉnh theo từng endpoint, điều proxy không làm được.
Bài viết liên quan
- FastAPI 0.163.0: giới hạn số request dùng chung một dependency bằng Depends(max_concurrency=…)
- FastAPI: xử lý việc nặng ở background với BackgroundTasks, client không phải chờ
- FastAPI: tùy chỉnh tài liệu OpenAPI — đổi tiêu đề, gắn tag mô tả, ẩn endpoint nội bộ trong 5 phút
Câu hỏi thường gặp
Mặc định FastAPI có giới hạn kích thước body không?
Không. Không đặt max_body_size ở đâu thì body không bị giới hạn, None chỉ có nghĩa là kế thừa giới hạn từ router hoặc app chứa endpoint đó.
Client nhận lỗi gì khi vượt giới hạn?
Vượt max_body_size thì nhận 413 Content Too Large; vượt giới hạn của form parser thì nhận 400, do Starlette từ chối ngay lúc parse form.
form_limits có chặn được file upload lớn không?
Không hoàn toàn. max_part_size chỉ giới hạn từng field text; chặn tổng dung lượng file thì dùng max_body_size.
💬 Tin này ảnh hưởng tới dự án của bạn thế nào? Chia sẻ góc nhìn của bạn trong phần bình luận — mình đọc hết và sẽ tổng hợp những ý hay nhất.
