Il primo server, se qualcosa va storto
Due terminali, due posti dove leggere
Gli errori che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai.
Con un server, i posti dove leggere sono due: il terminale del server (quello di fastapi dev) e quello del client (curl, o pytest). Quando qualcosa non va, guardali tutti e due.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
command not found: fastapi (o pytest: command not found) | Il venv è spento, oppure è acceso quello di un'altra cartella | source .venv/bin/activate, dalla cartella dello zip. Se il venv è nuovo: pip install -r requirements.txt |
zsh: no matches found: fastapi[standard] | Su Mac le quadre senza virgolette confondono il terminale | pip install "fastapi[standard]", con le virgolette |
Path does not exist lavagna.py | fastapi dev non trova il file: dalla cartella dello zip, il file sta dentro palestra/ | fastapi dev palestra/lavagna.py: il percorso dalla cartella in cui sei, .py compreso (senza, arriva Path does not exist palestra/lavagna) |
ERROR: [Errno 48] Address already in use (su Ubuntu [Errno 98]) | Sulla porta 8000 c'è già un server: quello dell'esercizio prima, in un altro terminale | Ctrl+C nel terminale dell'altro server. Oppure fastapi dev … --port 8001, e allora l'indirizzo è http://127.0.0.1:8001 |
curl: (7) Failed to connect | Dall'altra parte non c'è nessuno: il server è spento, o si è fermato per un errore | Guarda il primo terminale: riaccendilo con fastapi dev, o leggi perché si è fermato |
SyntaxError: expected ':' (all'avvio, o in pytest dopo ERROR collecting) | Manca il : in fondo alla riga del def | def conteggio_attrezzi():, con i due punti |
IndentationError: expected an indented block after function definition on line 45 | Il corpo della funzione non è rientrato sotto il def | Quattro spazi davanti a ogni riga del corpo |
assert 501 == 200 | C'è ancora la riga «da fare» | Al posto del raise HTTPException(status_code=501, …) il tuo codice. La riga va cancellata, non lasciata sopra |
assert None == … | La rotta non restituisce niente: c'è un print al posto del return, o il return manca | return e il dizionario, o la lista |
NameError: name 'null' is not defined (o 'true', 'false') | Hai scritto JSON dentro Python | None, True, False. Il JSON lo fa FastAPI |
assert 404 == 200, e sotto <Response [404 Not Found]> | La rotta non c'è: manca il decoratore, o il percorso è diverso da quello del test (una lettera, una maiuscola, la barra all'inizio) | Confronta il percorso del decoratore con quello del commento, lettera per lettera |
assert 405 == 200 | La rotta c'è, ma con un altro verbo | In questo capitolo tutte le rotte sono @app.get |
HTTP/1.1 307 Temporary Redirect, con il corpo vuoto | Hai chiesto il percorso con una barra in fondo (/annunci/): FastAPI ti rimanda a quello senza | Togli la barra, oppure curl -L per seguire il rimando |
Internal Server Error, codice 500 | La tua funzione si è rotta mentre rispondeva | L'errore vero è nel terminale del server: la sezione qui sotto |
/docs non si apre (Windows) | Il server deve girare nel terminale di Ubuntu | fastapi dev nel terminale di Ubuntu, poi http://127.0.0.1:8000/docs nel browser di Windows |
Il 500: l'errore è nell'altro terminale
Con il JSON del commento copiato nella rotta del turno, curl riceve questo:
curl -i http://127.0.0.1:8000/turnoHTTP/1.1 500 Internal Server Error
date: Thu, 19 Nov 2026 16:03:44 GMT
server: uvicorn
content-length: 21
content-type: text/plain; charset=utf-8
Internal Server ErrorIl client non saprà mai cos'è successo, ed è giusto così: sono affari del server. La spiegazione sta nel terminale del server, in un traceback lungo una settantina di righe:
INFO: 127.0.0.1:60041 - "GET /turno HTTP/1.1" 500 Internal Server Error
ERROR: Exception in ASGI application
Traceback (most recent call last):
…
File "~/corso/http-primo-server/palestra/turno.py", line 39, in riassunto_turno
return {"di_turno": "Ivo Brambati", "aiutante": null, "da_solo": true, "orario": [6, 14]}
^^^^
NameError: name 'null' is not definedSi legge dal basso: l'ultima riga dice cosa (NameError), quella con i ^^^^ quale pezzo, quella con File dove. Le righe di mezzo sono di uvicorn, di Starlette e di FastAPI: salendo dal basso, il primo File che incontri è il tuo, ed è quello giusto. Come si legge un traceback lungo: Leggere un traceback.
Nei test lo stesso errore arriva senza passare dal 500: TestClient te lo mostra direttamente, con la tua riga.
…
@app.get("/turno")
def riassunto_turno():
> return {"di_turno": "Ivo Brambati", "aiutante": null, "da_solo": true, "orario": [6, 14]}
^^^^
E NameError: name 'null' is not defined
palestra/turno.py:39: NameError
…Gli errori che non danno errori
I più difficili sono quelli senza traceback: il server risponde 200, ma la risposta è sbagliata. In questo capitolo sono quasi sempre uno di questi.
Il print al posto del return. Il client riceve null, e la lista che volevi mandare compare nel terminale del server. Il 200 vuol dire solo che la funzione è finita senza errori.
La risposta con la forma sbagliata. {"riparazioni": [...]} al posto di una lista, una stringa al posto di un oggetto, il JSON fatto due volte con json.dumps (una stringa piena di \"). Guarda la risposta con curl -s e confrontala con il commento sopra la rotta: la prima parentesi dice già se è un oggetto o una lista.
Il server che risponde come prima. Hai cambiato il codice, ma la risposta è quella vecchia. Quasi sempre il file non è salvato: nella scheda di VS Code c'è un pallino al posto della crocetta. Quando salvi, nel terminale del server deve comparire una riga come WatchFiles detected changes in 'palestra/riparazioni.py'. Reloading...: se non compare, il server non ha visto niente. Altrimenti guarda la riga Using import string all'avvio: forse è acceso il file di un altro esercizio.
I dati che tornano com'erano. A ogni riavvio, cioè a ogni salvataggio, i dati scritti nel file ripartono da capo: vivono nella memoria del server, non su un disco. Qui le rotte leggono soltanto e non te ne accorgi; da CRUD su un dizionario in poi sì.
Se il problema non è il codice
pytest: command not found, No module named pytest, il pannello Testing vuoto, No module named 'lavagna': non è il tuo codice, è l'ambiente. Ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente. Per FastAPI, Postman e il resto: il Pronto soccorso.