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.

45 phútTrung cấp
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
  1. Cho phép tải ảnh đại diện sinh viên.
  2. Ghi nhật ký bằng tác vụ nền.
  3. 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.