FastAPI es altamente testeable gracias a su TestClient (construido sobre Starlette/httpx) y su sistema de inyección de dependencias, lo que hace que hacer mock de dependencias sea trivial. Las pruebas típicamente usan pytest y el TestClient para enviar solicitudes a la app sin necesidad de un servidor en ejecución.
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
El TestClient envía solicitudes reales a tu app in-process (sin necesidad de servidor), así que pruebas el flujo completo — enrutamiento, validación, serialización — y verificas códigos de estado y respuestas 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
El dependency_overrides de FastAPI te permite reemplazar cualquier dependencia (sesión de base de datos, autenticación, servicios externos) con un doble de prueba — el fundamento de pruebas rápidas e aisladas, hecho trivial por el diseño de inyección de dependencias.
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
Las pruebas son esenciales para aplicaciones confiables, y FastAPI es notablemente testeable — entender cómo probarlo es importante tanto para la calidad del código como porque el framework está diseñado para ser testeable.
El TestClient hace que sea fácil probar el flujo completo de solicitud/respuesta in-process (sin necesidad de servidor), verificando enrutamiento, validación, serialización y respuestas tal como los clientes las experimentarían.
La característica destacada es la sobrescritura de dependencias: porque FastAPI usa inyección de dependencias, puedes reemplazar trivialmente cualquier dependencia — sesiones de base de datos, autenticación, servicios externos — con dobles de prueba a través de app.dependency_overrides, permitiendo pruebas rápidas e aisladas sin infraestructura real (esta testabilidad es un beneficio importante del diseño de inyección de dependencias).
Saber cómo usar el TestClient, sobrescribir dependencias para aislamiento (bases de datos de prueba, autenticación/servicios simulados), probar endpoints protegidos, y estructurar una estrategia de prueba sensata (códigos de estado, formas de respuesta, validación, autenticación, casos límite) es conocimiento importante de nivel senior para construir aplicaciones FastAPI robustas.
Las APIs bien probadas detectan regresiones y permiten refactorización confiada, y las herramientas de prueba de FastAPI hacen que las pruebas exhaustivas sean directas, haciendo de este un tema frecuentemente relevante e importante profesionalmente.