Vai al contenuto
code-to-code

Apro l'indice…

↑ ↓ per scegliere, Invio per aprire, Esc per chiudere

HTTP e API4. Il primo serverp. 108

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.

LeggiVuol direCosa fai
command not found: fastapi (o pytest: command not found)Il venv è spento, oppure è acceso quello di un'altra cartellasource .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 terminalepip install "fastapi[standard]", con le virgolette
Path does not exist lavagna.pyfastapi 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 terminaleCtrl+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 connectDall'altra parte non c'è nessuno: il server è spento, o si è fermato per un erroreGuarda 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 defdef conteggio_attrezzi():, con i due punti
IndentationError: expected an indented block after function definition on line 45Il corpo della funzione non è rientrato sotto il defQuattro spazi davanti a ogni riga del corpo
assert 501 == 200C'è 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 mancareturn e il dizionario, o la lista
NameError: name 'null' is not defined (o 'true', 'false')Hai scritto JSON dentro PythonNone, 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 == 200La rotta c'è, ma con un altro verboIn questo capitolo tutte le rotte sono @app.get
HTTP/1.1 307 Temporary Redirect, con il corpo vuotoHai chiesto il percorso con una barra in fondo (/annunci/): FastAPI ti rimanda a quello senzaTogli la barra, oppure curl -L per seguire il rimando
Internal Server Error, codice 500La tua funzione si è rotta mentre rispondevaL'errore vero è nel terminale del server: la sezione qui sotto
/docs non si apre (Windows)Il server deve girare nel terminale di Ubuntufastapi 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:

Terminale
curl -i http://127.0.0.1:8000/turno
HTTP/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 Error

Il 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 defined

Si 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.