FastAPI is zeer testbaar dankzij zijn TestClient (gebaseerd op Starlette/httpx) en zijn afhankelijkheidsinjectie-systeem, wat het trivaliseren van mocking van afhankelijkheden maakt. Tests gebruiken typisch pytest en de TestClient om verzoeken naar de app te sturen zonder een draaiende server.
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
De TestClient stuurt echte verzoeken naar je app in-process (geen server nodig), dus je test de volledige stroom — routing, validatie, serialisatie — en controleert statuscodes en JSON-antwoorden.
# 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
FastAPI's dependency_overrides laat je elke afhankelijkheid vervangen (databasesessie, auth, externe services) met een test double — de basis van snelle, geïsoleerde tests, triviaal gemaakt door het DI-ontwerp.
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
✓ 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
Testen zijn essentieel voor betrouwbare applicaties, en FastAPI is opvallend testbaar — begrijpen hoe je het test is belangrijk zowel voor codekwaliteit als omdat het framework ontworpen is voor testbaarheid.
De TestClient maakt het gemakkelijk om de volledige request/response-stroom in-process te testen (geen server nodig), waarbij routing, validatie, serialisatie en antwoorden worden geverifieerd zoals clients ze zouden ervaren.
De opvallende feature is afhankelijkheid overschrijven: omdat FastAPI dependency injection gebruikt, kun je trivaal elke afhankelijkheid vervangen — databasesessies, authenticatie, externe services — met test doubles via app.dependency_overrides, waardoor snelle, geïsoleerde tests zonder echte infrastructuur mogelijk zijn (deze testbaarheid is een groot voordeel van het DI-ontwerp).
Weten hoe je de TestClient gebruikt, afhankelijkheden overschrijft voor isolatie (testdatabases, gemockte auth/services), beveiligde endpoints test en een verstandige teststrategie structureert (statuscodes, antwoordvormen, validatie, auth, edge cases) is belangrijke senior-level kennis voor het bouwen van robuuste FastAPI-applicaties.
Goed geteste API's onderscheppen regressies en maken zelfverzekerd refactoring mogelijk, en FastAPI's testtools maken grondige tests eenvoudig, wat dit een veelvuldig relevant, professioneel-belangrijk onderwerp maakt.