FastAPI jest wysoce testowalny dzięki TestClient (zbudowanemu na Starlette/httpx) i jego systemowi dependency injection, który sprawia, że mockowanie zależności jest banalne. Testy zazwyczaj używają pytest i TestClient do wysyłania żądań do aplikacji bez uruchomionego serwera.
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 wysyła rzeczywiste żądania do aplikacji in-process (serwer nie jest potrzebny), dzięki czemu testujesz pełny przepływ — routing, walidację, serializację — i asertuje na kodach statusu oraz odpowiedziach JSON.
# 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 pozwala zastąpić dowolną zależność (sesję bazy danych, uwierzytelnianie, usługi zewnętrzne) test double — fundament szybkich, izolowanych testów, uczyniony trywialnym przez projekt DI.
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
Testowanie jest niezbędne dla niezawodnych aplikacji, a FastAPI jest szczególnie testowalny — zrozumienie sposobu jego testowania jest ważne zarówno dla jakości kodu, jak i dlatego, że framework jest zaprojektowany z myślą o testowaniu.
TestClient ułatwia testowanie pełnego przepływu żądań/odpowiedzi in-process (serwer nie jest potrzebny), weryfikując routing, walidację, serializację i odpowiedzi tak, jak doświadczyliby tego klienci.
Wydatną cechą jest nadpisywanie zależności: ponieważ FastAPI używa dependency injection, możesz trywialnie zastąpić dowolną zależność — sesje baz danych, uwierzytelnianie, usługi zewnętrzne — test double za pośrednictwem app.dependency_overrides, umożliwiając szybkie, izolowane testy bez rzeczywistej infrastruktury (ta testowalność jest główną zaletą projektu DI).
Wiedza jak używać TestClient, nadpisywać zależności dla izolacji (testowe bazy danych, mockowane usługi uwierzytelniające/zewnętrzne), testować chronione endpointy i strukturalizować sensowną strategię testowania (kody statusu, kształty odpowiedzi, walidacja, uwierzytelnianie, przypadki graniczne) jest ważną wiedzą na poziomie senior dla budowania solidnych aplikacji FastAPI.
Dobrze przetestowane API'i łapią regresje i umożliwiają pewny refactoring, a narzędzia testowe FastAPI czynią dogłębne testowanie prostym, czyniąc to często istotnym, zawodowo ważnym tematem.