Dependency injection (Depends) hoạt động như thế nào?

Question

Accepted Answer

Hệ thống **dependency injection** của FastAPI cho phép bạn khai báo các dependency tái sử dụng (function/class) mà FastAPI gọi và **tiêm** vào path operation của bạn qua `Depends()`. Nó được dùng cho logic dùng chung như database session, authentication, và các tham số chung — giữ code DRY và testable.

## Một dependency cơ bản

```python
from fastapi import Depends

# một dependency chỉ là một callable trả về thứ gì đó
def pagination(skip: int = 0, limit: int = 10):
    return {"skip": skip, "limit": limit}

@app.get("/items")
def list_items(params: dict = Depends(pagination)):   # FastAPI gọi pagination() và tiêm kết quả
    return params
# các query param skip/limit giờ được xử lý bởi dependency tái sử dụng
```

Khai báo `params = Depends(pagination)` báo cho FastAPI gọi `pagination` (cũng phân giải *các tham số của nó* từ request) và truyền kết quả vào function của bạn. Dependency này tái sử dụng được trên nhiều endpoint.

## Dependency có cleanup (yield) — ví dụ database session

```python
def get_db():
    db = SessionLocal()
    try:
        yield db                  # cung cấp session cho endpoint
    finally:
        db.close()                # cleanup chạy SAU response — được đảm bảo

@app.get("/users")
def list_users(db = Depends(get_db)):
    return db.query(User).all()    # dùng session được tiêm, tự đóng
```

Một dependency `yield` cung cấp một resource và chạy teardown sau request — pattern chuẩn cho database session (mở trước, đóng sau, tự động).

## Dependency có thể phụ thuộc vào dependency

```python
def get_current_user(token: str = Depends(get_token)):   # phụ thuộc vào một dependency khác
    return decode(token)

@app.get("/me")
def me(user: User = Depends(get_current_user)):           # auth qua injection
    return user
```

Các dependency tạo thành một cây — FastAPI phân giải toàn bộ chuỗi. Đây là cách authentication thường được làm (một dependency `get_current_user`).

## Dependency dạng class và tái sử dụng

```python
@app.get("/items", dependencies=[Depends(verify_api_key)])   # chạy một dependency mà không dùng giá trị trả về
def items(): ...                                              # ví dụ thực thi auth như một side effect
```

## Tại sao điều này quan trọng

Dependency injection là một trong những tính năng mạnh mẽ và quan trọng nhất của FastAPI — đó là cách bạn chia sẻ và tái sử dụng logic gọn gàng trên các endpoint (database session, authentication, tham số query chung, kiểm tra quyền) mà không trùng lặp.

Hiểu nó là thiết yếu vì nó làm nền tảng cho các pattern cốt lõi: **dependency `yield`** là cách chuẩn để quản lý database session (với cleanup được đảm bảo sau mỗi request), và một **dependency `get_current_user`** là cách idiomatic để triển khai authentication.

DI cũng khiến code rất **testable** — bạn có thể ghi đè dependency bằng mock trong test.

Sự thanh lịch của hệ thống (dependency phân giải tham số của chúng từ request, có thể phụ thuộc vào dependency khác tạo thành cây, và tích hợp với tài liệu) khiến nó là một công cụ linh hoạt để cấu trúc ứng dụng thực, nên thành thạo `Depends` là then chốt để xây dựng ứng dụng FastAPI được tổ chức tốt, dễ bảo trì, testable.