FastAPI высоко тестируемый фреймворк благодаря TestClient (построенному на Starlette/httpx) и его системе dependency injection, которая делает мокирование зависимостей тривиальным. Тесты обычно используют pytest и TestClient для отправки запросов к приложению без запущенного сервера.
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 отправляет реальные запросы к вашему приложению in-process (сервер не требуется), поэтому вы тестируете полный поток — маршрутизацию, валидацию, сериализацию — и проверяете коды состояния и 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 позволяет заменить любую зависимость (сессию базы данных, аутентификацию, внешние сервисы) на test double — основу быстрых, изолированных тестов, сделанную тривиальной благодаря 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
Тестирование является основополагающим для надёжных приложений, и FastAPI заметно тестируемый — понимание того, как его тестировать, важно как для качества кода, так и потому что фреймворк разработан с учётом тестируемости.
TestClient упрощает тестирование полного потока запрос/ответ in-process (сервер не требуется), проверяя маршрутизацию, валидацию, сериализацию и ответы так, как их будут воспринимать клиенты.
Основная особенность — переопределение зависимостей: поскольку FastAPI использует dependency injection, вы можете тривиально заменить любую зависимость — сессии БД, аутентификацию, внешние сервисы — на test doubles через app.dependency_overrides, обеспечивая быстрые, изолированные тесты без реальной инфраструктуры (эта тестируемость является основным преимуществом DI дизайна).
Знание того, как использовать TestClient, переопределять зависимости для изоляции (тестовые БД, мокированная аутентификация/сервисы), тестировать защищённые endpoint'ы и структурировать разумную стратегию тестирования (коды состояния, формы ответов, валидация, аутентификация, граничные случаи) — это важное знание senior уровня для создания надёжных приложений FastAPI.
Хорошо протестированные API перехватывают регрессии и позволяют уверенно выполнять рефакторинг, а инструменты тестирования FastAPI делают thorough testing простым, делая эту тему часто релевантной и профессионально важной.