FastAPI hỗ trợ những pattern dependency nâng cao nào?

Question

Accepted Answer

Ngoài `Depends` cơ bản, dependency injection của FastAPI hỗ trợ các pattern nâng cao: **sub-dependency**, **dependency có tham số** (dạng class hoặc qua factory), **resource có phạm vi** (yield), **dependency toàn cục/cấp router**, và **dependency override** cho test — biến nó thành một công cụ linh hoạt để cấu trúc ứng dụng thực.

## Sub-dependency (cây dependency)

```python
def get_token(authorization: str = Header()):
    return parse(authorization)

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

def get_admin(user: User = Depends(get_current_user)):    # đến lượt nó phụ thuộc vào cái đó
    if not user.is_admin: raise HTTPException(403)
    return user
# FastAPI phân giải toàn bộ chuỗi, cache các dependency dùng chung trong một request
```

Các dependency có thể phụ thuộc vào dependency khác, tạo thành một cây mà FastAPI phân giải tự động (và **cache** những cái dùng chung theo từng request, nên `get_token` chạy một lần dù được dùng bởi nhiều dependency).

## Dependency có tham số (dạng class)

```python
class RateLimiter:
    def __init__(self, calls: int):        # cấu hình dependency
        self.calls = calls
    def __call__(self, request: Request):  # callable → hoạt động như một dependency
        check_rate_limit(request, self.calls)

@app.get("/items", dependencies=[Depends(RateLimiter(calls=100))])  # cấu hình theo từng route
def items(): ...
```

Một class với `__call__` là một dependency **có thể cấu hình** — bạn tham số hóa nó tại thời điểm dùng (ví dụ rate limit khác nhau cho mỗi route).

## Dependency như side-effect (không cần trả về)

```python
@app.get("/admin", dependencies=[Depends(verify_admin)])   # chạy vì hiệu ứng (kiểm tra auth)
def admin(): ...                                            # không cần giá trị trả về của nó
```

## Dependency toàn cục và cấp router

```python
app = FastAPI(dependencies=[Depends(verify_api_key)])      # áp dụng cho MỌI route
router = APIRouter(dependencies=[Depends(get_current_user)])  # cho tất cả route trong một router
```

Áp dụng dependency toàn-app hoặc theo từng router cho các yêu cầu xuyên suốt (auth, rate limiting).

## Override cho test

```python
app.dependency_overrides[get_db] = get_test_db    # tráo bất kỳ dependency nào trong test
```

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

Dependency injection của FastAPI là một trong những tính năng mạnh mẽ nhất của nó, và các pattern nâng cao này là điều cho phép bạn cấu trúc các ứng dụng thực, phức tạp một cách thanh lịch.

Hiểu chúng là kiến thức cấp senior có giá trị: **sub-dependency** xây các lớp tái sử dụng (token → user → admin) với phân giải tự động và cache theo từng request (tránh công việc thừa); **dependency có tham số/dạng class** tạo các thành phần có thể cấu hình, tái sử dụng (rate limiter, kiểm tra quyền với cài đặt khác nhau cho mỗi route); **dependency như side-effect** thực thi gọn gàng các yêu cầu (auth) mà không làm rối signature của function; và **dependency toàn cục/cấp router** áp dụng các mối quan tâm xuyên suốt (authentication, rate limiting) cho cả nhóm route ở một nơi.

Then chốt là, **dependency override** khiến ngay cả các đồ thị dependency phức tạp trở nên dễ test.

Thành thạo các pattern này — kết hợp dependency, tham số hóa chúng, định phạm vi toàn cục hoặc theo router, và override chúng trong test — là điều cho phép kiến trúc sạch, DRY, testable trong các ứng dụng FastAPI không tầm thường, phân biệt các lập trình viên có thể tận dụng đầy đủ hệ thống DI của framework với những người chỉ dùng `Depends` cơ bản.

Đó là một chủ đề quan trọng để xây dựng app FastAPI có cấu trúc tốt, dễ bảo trì, quy mô lớn.