Làm thế nào để test ứng dụng FastAPI?

Question

Accepted Answer

FastAPI rất testable nhờ **`TestClient`** (xây trên Starlette/httpx) và hệ thống **dependency injection** của nó, vốn khiến việc mock dependency trở nên dễ dàng. Test thường dùng `pytest` và `TestClient` để gửi request đến app mà không cần một server đang chạy.

## Test endpoint cơ bản với TestClient

```python
from fastapi.testclient import TestClient
from main import app

client = TestClient(app)

def test_read_item():
    response = client.get("/items/5")            # gửi một request đến app trong-tiến-trình
    assert response.status_code == 200
    assert response.json() == {"item_id": 5}

def test_create_item():
    response = client.post("/items", json={"name": "Phone", "price": 999})
    assert response.status_code == 201
    assert response.json()["name"] == "Phone"

def test_validation_error():
    response = client.post("/items", json={"name": "Phone"})   # thiếu price
    assert response.status_code == 422                          # FastAPI validate tự động
```

`TestClient` gửi request thật đến app của bạn trong-tiến-trình (không cần server), nên bạn test toàn bộ luồng — routing, validation, serialization — và assert trên status code và response JSON.

## Ghi đè dependency (chìa khóa cho test sạch)

```python
# ghi đè một dependency bằng phiên bản mock/test — không cần database thật
def override_get_db():
    return test_db_session

app.dependency_overrides[get_db] = override_get_db   # tráo dependency thật

def test_with_test_db():
    response = client.get("/users")
    # dùng database test qua override
    app.dependency_overrides.clear()                 # reset sau đó
```

`dependency_overrides` của FastAPI cho phép bạn **thay thế bất kỳ dependency nào** (database session, auth, dịch vụ bên ngoài) bằng một test double — nền tảng của các test nhanh, cô lập, được làm cho dễ dàng nhờ thiết kế DI.

## Test endpoint được bảo vệ

```python
def test_protected():
    # ghi đè dependency auth để giả lập một user đã đăng nhập
    app.dependency_overrides[get_current_user] = lambda: fake_user
    response = client.get("/me")
    assert response.status_code == 200
```

## Chiến lược test

```text
✓ Dùng một database TEST (riêng biệt, hoặc transaction được rollback mỗi test)
✓ Ghi đè dependency (DB, auth, API bên ngoài) để cô lập
✓ Test: status code, hình dạng response, validation (422), auth/quyền, edge case
✓ Cho code async cụ thể, dùng httpx.AsyncClient / pytest-asyncio
✓ Công cụ: pytest, thư viện factory cho dữ liệu test, coverage.py
```

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

Test thiết yếu cho ứng dụng đáng tin cậy, và FastAPI đặc biệt testable — hiểu cách test nó quan trọng cả cho chất lượng code lẫn vì framework được *thiết kế* cho khả năng test. **`TestClient`** khiến dễ test toàn bộ luồng request/response trong-tiến-trình (không cần server), xác minh routing, validation, serialization, và response đúng như client sẽ trải nghiệm.

Tính năng nổi bật là **dependency override**: vì FastAPI dùng dependency injection, bạn có thể dễ dàng thay thế bất kỳ dependency nào — database session, authentication, dịch vụ bên ngoài — bằng test double qua `app.dependency_overrides`, cho phép các test nhanh, cô lập mà không cần hạ tầng thật (khả năng test này là một lợi ích lớn của thiết kế DI).

Biết cách dùng TestClient, ghi đè dependency để cô lập (database test, mock auth/dịch vụ), test endpoint được bảo vệ, và cấu trúc một chiến lược test hợp lý (status code, hình dạng response, validation, auth, edge case) là kiến thức cấp senior quan trọng để xây dựng ứng dụng FastAPI bền vững.

API được test tốt bắt regression và cho phép refactor tự tin, và công cụ test của FastAPI khiến test kỹ lưỡng đơn giản, biến đây thành một chủ đề thường liên quan, quan trọng về mặt chuyên môn.