คุณทดสอบแอปพลิเคชัน FastAPI ได้อย่างไร?

Question

Accepted Answer

FastAPI ทดสอบได้สูงเพราะ **`TestClient`** (สร้างบน Starlette/httpx) และระบบ **dependency injection** ของมัน ซึ่งทำให้การ mock dependencies ง่ายมาก การทดสอบมักใช้ `pytest` และ `TestClient` เพื่อส่ง request ไปยังแอปโดยไม่ต้องมี server ที่รันอยู่

## การทดสอบ endpoint พื้นฐานด้วย TestClient

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

client = TestClient(app)

def test_read_item():
    response = client.get("/items/5")            # send a request to the app in-process
    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"})   # missing price
    assert response.status_code == 422                          # FastAPI validates automatically
```

`TestClient` ส่ง request จริงไปยังแอปของคุณแบบ in-process (ไม่ต้องมี server) ดังนั้นคุณจึงทดสอบ flow ทั้งหมด — routing, validation, serialization — และ assert บน status codes และ JSON responses

## การ override dependencies (กุญแจสู่การทดสอบที่สะอาด)

```python
# override a dependency with a mock/test version — no real database needed
def override_get_db():
    return test_db_session

app.dependency_overrides[get_db] = override_get_db   # swap the real dependency

def test_with_test_db():
    response = client.get("/users")
    # uses the test database via the override
    app.dependency_overrides.clear()                 # reset after
```

`dependency_overrides` ของ FastAPI ช่วยให้คุณ **แทนที่ dependency ใดก็ได้** (database session, auth, external services) ด้วย test double — เป็นรากฐานของการทดสอบที่เร็วและแยกเป็นอิสระ ซึ่งง่ายมากด้วยการออกแบบ DI

## การทดสอบ endpoints ที่ป้องกันไว้

```python
def test_protected():
    # override the auth dependency to simulate a logged-in user
    app.dependency_overrides[get_current_user] = lambda: fake_user
    response = client.get("/me")
    assert response.status_code == 200
```

## กลยุทธ์การทดสอบ

```text
✓ Use a TEST database (separate, or transactions rolled back per test)
✓ Override dependencies (DB, auth, external APIs) for isolation
✓ Test: status codes, response shapes, validation (422s), auth/permissions, edge cases
✓ For async-specific code, use httpx.AsyncClient / pytest-asyncio
✓ Tools: pytest, factory libraries for test data, coverage.py
```

## ทำไมจึงสำคัญ

การทดสอบเป็นสิ่งจำเป็นสำหรับแอปพลิเคชันที่เชื่อถือได้ และ FastAPI ทดสอบได้อย่างโดดเด่น — การเข้าใจวิธีทดสอบมันมีความสำคัญทั้งต่อคุณภาพโค้ดและเพราะ framework *ถูกออกแบบ* มาเพื่อความสามารถในการทดสอบ

**`TestClient`** ทำให้ง่ายต่อการทดสอบ flow ของ request/response ทั้งหมดแบบ in-process (ไม่ต้องมี server) ตรวจสอบ routing, validation, serialization และ responses เหมือนที่ clients จะได้พบ

ฟีเจอร์ที่โดดเด่นคือ **dependency overrides**: เนื่องจาก FastAPI ใช้ dependency injection คุณจึงแทนที่ dependency ใดก็ได้อย่างง่ายดาย — database sessions, การยืนยันตัวตน, external services — ด้วย test doubles ผ่าน `app.dependency_overrides` ทำให้การทดสอบเร็วและแยกเป็นอิสระโดยไม่ต้องมี infrastructure จริง (ความสามารถในการทดสอบนี้เป็นประโยชน์หลักของการออกแบบ DI)

การรู้วิธีใช้ TestClient, override dependencies เพื่อความแยกอิสระ (test databases, auth/services ที่ mock), ทดสอบ endpoints ที่ป้องกันไว้ และจัดโครงสร้างกลยุทธ์การทดสอบที่สมเหตุสมผล (status codes, รูปแบบ response, validation, auth, edge cases) เป็นความรู้ระดับ senior ที่สำคัญสำหรับการสร้างแอป FastAPI ที่แข็งแกร่ง

API ที่ทดสอบดีจะจับ regressions ได้และเปิดทางให้ refactor อย่างมั่นใจ และเครื่องมือการทดสอบของ FastAPI ทำให้การทดสอบอย่างละเอียดเป็นเรื่องตรงไปตรงมา ทำให้นี่เป็นหัวข้อที่เกี่ยวข้องบ่อยและสำคัญในเชิงวิชาชีพ