FastAPI è altamente testabile grazie al suo TestClient (costruito su Starlette/httpx) e al suo sistema di dependency injection, che rende banale il mocking delle dipendenze. I test in genere utilizzano pytest e TestClient per inviare richieste all'app senza un server in esecuzione.
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
Il TestClient invia richieste reali alla tua app in-process (nessun server necessario), così puoi testare il flusso completo — routing, validazione, serializzazione — e verificare i codici di stato e le risposte 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
Il dependency_overrides di FastAPI ti consente di sostituire qualsiasi dipendenza (sessione del database, autenticazione, servizi esterni) con un test double — il fondamento di test veloci e isolati, reso banale dal design dell'injection di dipendenze.
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
Il testing è essenziale per applicazioni affidabili, e FastAPI è notevolmente testabile — capire come testarlo è importante sia per la qualità del codice che perché il framework è progettato per la testabilità.
Il TestClient rende facile testare il flusso completo richiesta/risposta in-process (nessun server necessario), verificando routing, validazione, serializzazione e risposte esattamente come i client le sperimenterebbero.
La caratteristica più importante è il override delle dipendenze: poiché FastAPI utilizza l'injection di dipendenze, puoi facilmente sostituire qualsiasi dipendenza — sessioni del database, autenticazione, servizi esterni — con test double tramite app.dependency_overrides, abilitando test veloci e isolati senza infrastruttura reale (questa testabilità è un vantaggio significativo del design di DI).
Sapere come utilizzare TestClient, eseguire l'override delle dipendenze per l'isolamento (database di test, auth/servizi mockati), testare endpoint protetti e strutturare una strategia di test sensata (codici di stato, forme di risposta, validazione, autenticazione, casi limite) è una conoscenza importante a livello senior per costruire applicazioni FastAPI robuste.
Le API ben testate catturano le regressioni e consentono il refactoring con fiducia, e gli strumenti di testing di FastAPI rendono il testing approfondito semplice, rendendo questo un argomento frequentemente rilevante e professionalmente importante.