Il viaggio di una richiesta, se qualcosa va storto
I messaggi da leggere e le cose che si confondono
In questo capitolo non scrivi codice che gira: leggi viaggi già fatti. Gli errori quindi sono di due tipi. Quelli con un messaggio (un test, curl, il server che non parte) e quelli senza: due pezzi del viaggio che si somigliano e si scambiano. Prima i primi.
Nei test
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
AssertionError: Manca la risposta: al posto di None scrivi la tua. | Al posto della risposta c'è ancora None | Scrivi la tua risposta dopo l'=, e salva il file |
AssertionError: Non è questa. Rileggi … | La risposta c'è, ma non è giusta | Rileggi la domanda parola per parola: chiede il nome o il valore? il percorso con o senza la query? un numero o un testo? Poi le confusioni qui sotto |
SyntaxError: invalid syntax, con una freccia sotto la tua risposta | Un testo senza virgolette: RISPOSTA_1B = /treni. Python prova a leggerlo come codice, e non ci riesce | Le virgolette: RISPOSTA_1B = "/treni". I numeri invece vanno senza |
NameError: name 'NoneType' is not defined (o 'null', 'GET'…) | Una parola senza virgolette: Python cerca una variabile con quel nome, e non c'è | Tra virgolette: "NoneType" |
ERROR collecting palestra/test_… e Interrupted: 1 error during collection | Il file dell'esercizio non si carica, quindi nessun test parte | Guarda le righe che cominciano con E: dicono il file, la riga e il motivo |
Per esempio, con RISPOSTA_1B = /treni senza virgolette, pytest palestra/test_domanda_di_lucia.py -v si ferma così (accorciato):
________________________ ERROR collecting palestra/test_domanda_di_lucia.py ________________________
…
palestra/test_domanda_di_lucia.py:9: in <module>
from domanda_di_lucia import RISPOSTA_1A, RISPOSTA_1B, RISPOSTA_1C, RISPOSTA_1D
E File "~/corso/http-viaggio-di-una-richiesta/palestra/domanda_di_lucia.py", line 30
E RISPOSTA_1B = /treni
E ^
E SyntaxError: invalid syntax
===================================== short test summary info ======================================
ERROR palestra/test_domanda_di_lucia.py
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Interrupted: 1 error during collection !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!Si legge dal basso, come in Leggere un traceback: l'errore è un SyntaxError, nel file domanda_di_lucia.py, alla riga 30, e la freccia indica proprio la / senza virgolette.
Con curl e con InfoMenta
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
curl: (7) Failed to connect to 127.0.0.1 port 8000 after 0 ms: Couldn't connect to server | Su quella porta non risponde nessuno: InfoMenta è spenta | Accendila nel primo terminale (fastapi dev palestra/infomenta.py) e lascialo aperto. curl va nel secondo |
zsh: no matches found: http://127.0.0.1:8000/treni?stazione_id=5 | L'indirizzo è senza virgolette, e il terminale del Mac legge il ? a modo suo | Virgolette doppie intorno all'indirizzo: curl -i "http://…". Su Ubuntu non c'è l'errore, ma con un & la query si taglia: virgolette sempre |
curl: (3) URL rejected: Malformed input to a URL function | Nell'indirizzo c'è uno spazio | Toglilo. Se lo spazio serve davvero, si scrive %20 |
HTTP/1.1 404 Not Found con il corpo {"detail":"Not Found"} | Il server è acceso e ha risposto, ma quel percorso non esiste | Confronta il percorso lettera per lettera: /partenza non è /partenze |
command not found: fastapi | Il venv è spento | source .venv/bin/activate, dalla cartella dello zip, poi di nuovo fastapi dev |
ERROR: [Errno 48] Address already in use (su Ubuntu [Errno 98]) | InfoMenta, o un altro server, è già accesa in un altro terminale | Usa quella che c'è già, oppure Ctrl+C di là e riaccendi qui. In alternativa --port 8001, e negli indirizzi 8001 |
Il browser di Windows non apre http://127.0.0.1:8000 | Il server deve girare nel terminale di Ubuntu (WSL) | fastapi dev nel terminale di Ubuntu; poi l'indirizzo nel browser di Windows funziona |
Il 404 di un percorso sbagliato, dal vivo:
curl -i http://127.0.0.1:8000/partenzaHTTP/1.1 404 Not Found
date: Thu, 19 Nov 2026 15:55:35 GMT
server: uvicorn
content-length: 22
content-type: application/json
{"detail":"Not Found"}Una risposta è arrivata, quindi InfoMenta è accesa: il viaggio è andato, ma all'indirizzo sbagliato. Con il server spento invece la risposta non arriva proprio, e parla curl, con il suo (7).
Le confusioni
Gli errori più frequenti del capitolo non hanno un messaggio: sono due pezzi del viaggio che si somigliano. Quasi sempre è una di queste coppie.
Il percorso e la query. Nella riga di richiesta stanno attaccati: /treni?stazione_id=5. Ma il percorso finisce al ?, ed è /treni. Quello che segue è la query.
Il nome e il valore di un header. In content-type: application/json il nome è prima dei due punti, il valore dopo. Leggi bene cosa chiede la domanda.
L'header della richiesta e quello della risposta. In una POST Content-Type c'è due volte: nella richiesta dice di che tipo è il corpo che mandi, nella risposta quello che ricevi. La richiesta finisce alla sua riga vuota; la risposta comincia con HTTP/1.1 e il codice.
Il codice di stato e il codice del treno. 200 è il codice di stato, nella prima riga della risposta. "M16" è il codice del treno, un campo del corpo. Stessa parola, due cose.
null e None, false e False. Le prime sono parole del JSON, le seconde di Python. json.loads fa la traduzione: in un file Python si scrive sempre None e False.
Il valore e il suo tipo. None è un valore, e il suo tipo si chiama NoneType. [ … ] in JSON è una lista: in Python, list. Quando la domanda dice «come lo scrive type()», vuole il tipo.
127.0.0.1 non è un sito. Vuol dire «questo computer», sempre. Se Rosa scrivesse http://127.0.0.1:8000 sul suo telefono, il telefono cercherebbe InfoMenta dentro il telefono. Sul tuo computer funziona perché InfoMenta è accesa lì.
Se il problema non è il codice
pytest: command not found, No module named pytest, il pannello Testing vuoto, No module named 'domanda_di_lucia': non sono le tue risposte, è l'ambiente. È il guaio più comune in assoluto, e ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente. Per i guai del server (Address already in use, /docs che non si apre) c'è la sezione FastAPI del Pronto soccorso.