Il debugger su FastAPI e nei test, se qualcosa va storto
Il server che non parte, il browser che aspetta, lo zip
Due parti. Prima gli errori del capitolo: il server che non parte, il breakpoint che non scatta, /docs che non risponde. Poi quelli dello zip, che non c'entrano con il tuo codice.
Ricorda come si legge un messaggio d'errore: dal basso, l'ultima riga dice che cosa. Se è un traceback, tutto il resto è in Leggere un traceback.
Gli errori del capitolo
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
Error loading ASGI app. Could not import module "main". | uvicorn non trova main.py: in launch.json manca --app-dir, oppure punta a una cartella sbagliata (anche solo un gradino sopra o sotto) | Negli args: "--app-dir", "palestra/centrale", cioè la cartella che contiene main.py, a partire da quella aperta in VS Code. Prova gli stessi pezzi nel terminale con python -m uvicorn |
Error loading ASGI app. Attribute "x" not found in module "main". | Il file c'è, ma dopo i due punti hai scritto un nome che non esiste | Dopo main: ci va il nome della variabile con FastAPI(): di solito app |
Usage: python -m uvicorn [OPTIONS] APP e Missing argument 'APP' | Negli args manca main:app | Aggiungilo come primo pezzo |
address already in use (con Errno 48 o Errno 98) | C'è già un server su quella porta | Spegnilo: Ctrl+C nel terminale dove gira, oppure ■ Stop · Shift+F5. Poi di nuovo il triangolo verde |
/docs gira all'infinito, la richiesta non finisce | Il server è fermo su un breakpoint, e aspetta te | Guarda VS Code: c'è la riga gialla. Leggi VARIABLES, poi ▶ Continue · F5 (su Mac fn+F5), tante volte quante servono |
Il breakpoint non scatta, /docs risponde subito | La richiesta non passa da quella riga: un if precedente la scavalca (un 404, un ciclo con la lista vuota) | Guarda cosa ha risposto /docs. Sposta il pallino prima, oppure scegli un parametro per cui la riga viene eseguita |
| Il pallino è grigio e vuoto | Il debugger non è attivo, o la riga non è codice (un commento, una riga vuota) | Accendi il server con il triangolo verde. Sposta il pallino su una riga con del codice |
| Ho corretto ma risponde come prima | Senza --reload il server tiene in memoria il codice vecchio | ↻ Restart · Cmd+Shift+F5 (Windows: Ctrl+Shift+F5) |
Con --reload nei args i breakpoint non scattano, o spariscono dopo un salvataggio | Il server gira in un secondo processo, che si riavvia a ogni modifica | Togli --reload dagli args |
| F5 non parte il server, ma esegue il file aperto | È selezionato Il file aperto nel menu di Run and Debug, non la configurazione del server | Nel menu in alto, accanto al triangolo, scegli la configurazione con uvicorn |
F5 chiede Select debugger | VS Code non vede .vscode/launch.json: è aperto su un'altra cartella | File → Open Folder → proprio la cartella dello zip |
| Il pannello Testing è vuoto, o il test non si ferma | VS Code usa un altro Python, o pytest non è acceso per quella cartella | Python: Select Interpreter → quello con .venv. Poi guarda il Pronto soccorso |
assert 4.5 == 6 (o simili) senza nessun traceback | Il test è rosso per un valore, non per un errore: il codice gira ma sbaglia | È il caso di Debug Test: il pallino dove nasce il valore, poi VARIABLES. Il metodo è in I bug silenziosi |
| Debug Test si ferma sul test e non sul codice | Il pallino è nel test, e non dentro main.py | Metti il pallino nella riga della rotta, o della funzione che il test chiama |
| Le estensioni Python e Python Debugger non ci sono (Windows con WSL) | Sono installate in Windows, non in Ubuntu | Dal pannello delle estensioni: Install in WSL: Ubuntu. In basso a sinistra deve esserci WSL: Ubuntu |
Gli errori dello zip
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
Manca la risposta: al posto di None scrivi la tua. | In risposte.py c'è ancora None | Scrivi la tua risposta al posto di None (un numero, senza virgolette) |
Non è questo. La riga gialla non è ancora stata eseguita… | La tua risposta non è quella: è un consiglio, non il valore giusto | Rifai la prova, guarda VARIABLES alla fermata giusta, e leggi prima della riga gialla |
l'hai modificato? Riprendilo dallo zip, così com'era. | Hai cambiato la riga con il triangolo ◀ in main.py, o l'hai cancellata: il test non la trova più | Rimettila com'era. Il commento con ◀ non va tolto. Se il file non è più riconoscibile, riprendi main.py dallo zip |
Su quella riga il programma si ferma 2 volte, non 3 | Il test non riesce a fermarsi dove si aspetta: i dati di SEGNALAZIONI, il for o la riga con ◀ sono cambiati | Come sopra: riprendi main.py dallo zip, e rifai l'esercizio 3 da lì. |
In launch.json non c'è ancora una configurazione con "module": "uvicorn". | La configurazione non c'è, o l'hai scritta con "program" invece di "module" | Dentro la lista configurations, un blocco nuovo con "module": "uvicorn" |
Manca "--app-dir" o La cartella di --app-dir non è quella che contiene main.py | La cartella negli args non è palestra/centrale | Scrivila come percorso dalla cartella dello zip: palestra/centrale |
Togli "--reload" | C'è ancora --reload negli args | Toglilo, con la virgola che lo precede |
Prima di correggere, sopra la riga: # BUG: … | Manca il commento, oppure comincia con #BUG senza spazio, o con un altro testo | Una riga che comincia con # BUG:, uno spazio, e il perché |
pytest: command not found | Il venv è spento | source .venv/bin/activate, dalla cartella dello zip |
ModuleNotFoundError: No module named 'fastapi' | FastAPI non è installato nel venv | Con il venv acceso: pip install -r requirements.txt |
No module named 'risposte' | Hai lanciato pytest da un'altra cartella | cd nella cartella dello zip, poi di nuovo pytest |
Gli errori che non danno errori
launch.json si scrive, il server parte, e sembra tutto a posto. Ma il pallino resta grigio e non succede niente. Controlla tre cose, nell'ordine: stai guardando la configurazione giusta nel menu (non «Il file aperto»)? Dentro gli args c'è --reload? La richiesta passa davvero dalla riga dove hai messo il pallino?
Il test passa, ma il debugger non si è mai fermato. Il test non passava da lì. Metti un print provvisorio nella riga, o un pallino più in alto, e rilancia.
Ho fatto Restart, ma la risposta è quella di prima. Il browser ti sta rimostrando la risposta vecchia. Premi di nuovo Execute in /docs: non ricarica da solo.
Se il problema non è il codice
pytest: command not found, il pannello Testing vuoto, F5 che chiede Select debugger, il breakpoint che non si ferma, /docs che gira all'infinito: sono cure brevi nel Pronto soccorso. E se pytest non parte proprio: pytest non parte, o non trova niente.