Bài này bổ sung các chức năng thường gặp của API: nhận tệp tải lên, chạy tác vụ nền (gửi email, xử lý ảnh) và cho phép frontend React, Vue gọi API qua CORS.
Bạn sẽ học được
- UploadFile
- BackgroundTasks
- Cấu hình CORS
- Phục vụ tệp tĩnh
Cơ sở lý thuyết
Tải tệp trong HTTP dùng định dạng multipart/form-data: thân yêu cầu chia thành nhiều phần, mỗi phần là một trường form hoặc một tệp. UploadFile của FastAPI dùng tệp tạm có giới hạn bộ nhớ (SpooledTemporaryFile): tệp nhỏ giữ trong RAM, tệp lớn tự ghi ra đĩa, không làm cạn bộ nhớ máy chủ.
- Tác vụ nền (BackgroundTasks) chạy sau khi đã trả phản hồi, trong cùng tiến trình – phù hợp việc nhẹ (gửi email, ghi log). Việc nặng hoặc cần đảm bảo không mất (xử lý video) nên dùng hàng đợi riêng như Celery, RQ, Arq.
- CORS (Cross-Origin Resource Sharing): trình duyệt áp dụng chính sách cùng nguồn gốc, chặn JavaScript đọc phản hồi từ nguồn gốc khác; máy chủ phải trả header Access-Control-Allow-Origin để cho phép.
- Bảo mật tải tệp: giới hạn kích thước, kiểm tra loại theo nội dung, đổi tên ngẫu nhiên (uuid) để tránh ghi đè và tấn công đường dẫn (../../).
Ví dụ
from fastapi import UploadFile, BackgroundTasks
from fastapi.middleware.cors import CORSMiddleware
from fastapi.staticfiles import StaticFiles
app.add_middleware(CORSMiddleware, allow_origins=["http://localhost:5173"],
allow_methods=["*"], allow_headers=["*"])
app.mount("/tep", StaticFiles(directory="uploads"), name="tep")
def ghi_log(noi_dung: str):
with open("log.txt", "a", encoding="utf-8") as f:
f.write(noi_dung + "\n")
@app.post("/anh")
async def tai_anh(tep: UploadFile, nen: BackgroundTasks):
if tep.content_type not in ("image/png", "image/jpeg"):
raise HTTPException(400, "Chỉ nhận ảnh PNG, JPEG")
duong_dan = "uploads/" + tep.filename
with open(duong_dan, "wb") as f:
f.write(await tep.read())
nen.add_task(ghi_log, "Đã tải " + tep.filename)
return {"url": "/tep/" + tep.filename}Ứng dụng thực tế
Bài toán: sinh viên nộp bài tập dạng PDF; hệ thống lưu với tên an toàn, giới hạn 10 MB, ghi nhận thời điểm nộp và gửi email xác nhận ở tác vụ nền:
import uuid, pathlib
GIOI_HAN = 10 * 1024 * 1024
@app.post("/nop-bai/{ma_bai}")
async def nop_bai(ma_bai: str, tep: UploadFile, nen: BackgroundTasks, sv: SinhVienHienTai):
noi_dung = await tep.read()
if len(noi_dung) > GIOI_HAN:
raise HTTPException(413, "Tệp vượt quá 10 MB")
if not noi_dung.startswith(b"%PDF"): # kiểm tra chữ ký tệp, không tin phần mở rộng
raise HTTPException(415, "Chỉ nhận tệp PDF")
ten_moi = f"{ma_bai}_{sv.ma}_{uuid.uuid4().hex}.pdf"
pathlib.Path("bai_nop", ten_moi).write_bytes(noi_dung)
nen.add_task(gui_email_xac_nhan, sv.email, ma_bai)
return {"tep": ten_moi, "kich_thuoc": len(noi_dung)}Thực hành
- Cho phép tải ảnh đại diện sinh viên.
- Ghi nhật ký bằng tác vụ nền.
- Gọi API từ ứng dụng React.
Tóm tắt bài học
- UploadFile nhận tệp.
- BackgroundTasks chạy sau khi trả phản hồi.
- CORSMiddleware cho phép frontend gọi API.

