Un pezzo alla volta, se qualcosa va storto
Gli errori del capitolo, uno per uno
Gli errori che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai. Quasi tutti hanno un nome che dice già dove cercare.
La regola che vale per tutti è quella del capitolo: se non capisci dove sta il guaio, torna all'ultimo commit verde e fai il pezzo più piccolo. Un errore dopo cinque righe nuove ha cinque sospetti; dopo trenta righe nuove, trenta.
Il traceback si legge dal basso: l'ultima riga dice cosa, la riga con File … line … dice dove (Leggere un traceback).
Il test rosso, e cosa dice
Prima di tutto: un test rosso che fa il suo mestiere non è un guaio. Il primo test di ogni pezzo deve essere rosso. Il guaio è un test rosso per il motivo sbagliato.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
assert 404 == 200 | La rotta non c'è. Per FastAPI è la stessa cosa se il file non esiste, se il router non è montato o se il percorso è sbagliato | Controlla, in ordine: il file in app/rotte/; app.include_router(…) in main.py; il prefisso e il percorso della rotta |
assert 405 == 201 | Il percorso c'è, ma non per quel verbo: hai scritto la GET e manca la POST | Il decoratore: @router.post(""), non @router.get("") |
assert 501 == 200 | C'è ancora la riga del «da fare» | Al suo posto, il tuo codice |
ImportError o ModuleNotFoundError nel test appena scritto | Il test è rosso per il motivo sbagliato: l'import, non la rotta | Sistema l'import: from app.main import app, dalla cartella ritrovato/ |
ModuleNotFoundError: No module named 'app' | Hai lanciato pytest (o fastapi dev) da un'altra cartella: Python non trova app/ | cd nella cartella del progetto (storia/ritrovato/): lì c'è il pytest.ini con pythonpath = . |
HTTP/1.1 307 Temporary Redirect in curl -i (il TestClient dei test il redirect lo segue, e il test resta verde) | La rotta è scritta @router.get("/") e il router ha già il prefisso: GET /oggetti viene mandato a /oggetti/ | Nel router con il prefisso, il percorso della lista è "": @router.get("") |
assert 404 == 201 su una POST | Come il primo: il router non c'è, o il percorso è sbagliato. Nella storia, il livello 6 ha un file nuovo, restituzioni.py, con il suo include_router | main.py: ci sono tutte le righe include_router? |
La riga 404 merita una frase in più. Capita a tutti: la rotta è scritta giusta, il test è rosso, e il guaio sta in main.py. Quando una rotta «non c'è», guarda main.py prima di guardare la rotta.
Gli errori con un nome
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
InvalidRequestError: Instance '<OggettoDB at 0x…>' is not persistent within this Session | Hai fatto db.refresh su un oggetto che non è stato salvato: manca il db.commit() | add, commit, e solo dopo refresh |
IntegrityError: (psycopg.errors.NotNullViolation) null value in column "registrato_da" of relation "oggetti" violates not-null constraint | Una colonna NOT NULL è rimasta vuota: qui, il valore finto non l'hai messo | OggettoDB(**dati.model_dump(), registrato_da=ADDETTO_FINTO) |
IntegrityError: (psycopg.errors.ForeignKeyViolation) … Key (stazione_id)=(9) is not present in table "stazioni" | Il valore punta a una riga che non esiste, e nessuno l'ha controllato | Prima della scrittura: db.get(StazioneDB, dati.stazione_id), e se è None rispondi tu |
IntegrityError: (psycopg.errors.UniqueViolation) duplicate key value violates unique constraint "…_key" | Hai scritto un valore che deve essere unico, e c'è già: il database ha detto no | Controlla prima, e rispondi 409 |
UniqueViolation … "prenotazioni_pkey", Key (id)=(1) already exists | Hai scritto tu l'id: lo sceglie il database | Togli id=… dall'oggetto |
ResponseValidationError … Input should be a valid dictionary or object to extract fields from, con 'input': None | La rotta ha restituito None: manca l'if … is None con il 404 | L'if, prima del return |
ResponseValidationError … Field required, con 'input': (<modelli.CampoDB object at 0x…>,) | Hai usato db.execute(…).all(): arrivano righe, non oggetti | db.scalars(…).all() |
AttributeError: 'NoneType' object has no attribute 'stato' | db.get ha dato None e sei andato avanti | Subito dopo: if oggetto is None: e il 404 |
UnmappedInstanceError: Class 'builtins.NoneType' is not mapped | A db.delete hai passato None: la riga non c'era | if … is None con il 404, prima di db.delete |
NoInspectionAvailable: No inspection system is available for object of type <class 'pydantic._internal._model_construction.ModelMetaclass'> | A db.get hai passato lo stampo (Prenotazione) al posto della classe-tabella | db.get(PrenotazioneDB, …): dentro va la classe con il DB |
OperationalError: … database "ritrovato" does not exist | DATABASE_URL (o il valore di ripiego in database.py) punta a un database che non hai creato | createdb ritrovato, poi psql -d ritrovato -f schema.sql |
ProgrammingError: (psycopg.errors.UndefinedTable) relation "stazioni" does not exist | Il database c'è, ma è vuoto | psql -d ritrovato -f schema.sql, poi i dati |
422 Unprocessable Content in /docs | Il corpo che hai mandato non rispetta lo stampo: manca un campo, o un valore non è ammesso (una categoria che non c'è, un documento di cinque cifre) | Leggi il detail della risposta: dice quale campo e cosa non va |
Gli errori che non danno errori
Sono i peggiori: non c'è un messaggio, c'è un risultato strano.
| Vedi | Vuol dire | Cosa fai |
|---|---|---|
Tutti i test sono verdi, ma in /docs la rotta non salva niente | Il test controlla la risposta e non il database. Manca il commit, e il test non se n'è accorto | Aggiungi un test che guarda dentro il database (sql("SELECT …")): è l'esempio D |
/docs mostra [] o una lista più corta del previsto | Stai guardando il tuo database, e quello è vuoto (o sbagliato). Il test, invece, ha il suo | psql -d ritrovato -c "SELECT count(*) FROM oggetti": se è 0, carica i dati |
I test passano, e dopo aver provato /docs i dati sono cambiati | /docs lavora sul tuo database e ci scrive davvero. I test no: hanno il loro | Normale. Per ripartire dai dati di prova: rilancia il file .sql dei dati |
| L'oggetto restituito compare ancora nell'elenco | La rotta della restituzione ha scritto la restituzione e non ha cambiato lo stato | oggetto.stato = "restituito" prima del commit |
| Il filtro con due parametri ne ignora uno | Hai scritto elif al posto del secondo if | Un if per filtro, tutti separati |
| Un oggetto compare con un filtro e non con un altro | Il where di un filtro cancella quello dell'altro: hai scritto domanda = select(…).where(…) invece di domanda = domanda.where(…) | Il filtro si aggiunge alla domanda che hai già |
| Il segno particolare esce nel JSON pubblico | Lo stampo di risposta lo include: l'hai copiato da OggettoNuovo | Lo stampo Oggetto, quello senza il segno |
Gli errori del metodo
Non danno un messaggio, ma costano ore. Un test verde che non guarda il database non dice «fatto».
| Succede | Perché | Cosa fai |
|---|---|---|
| «Ho scritto tutti i modelli, tutti gli stampi e tutte le rotte, e adesso non parte» | Hai fatto a strati: il primo test è arrivato dopo dodici cose | Commenta tutto tranne un pezzo: lascia una rotta sola, e falla camminare. Poi il pezzo dopo |
| Due test rossi nello stesso momento, e non so quale causa cosa | Hai cominciato il pezzo 4 senza finire il 3 | Torna all'ultimo commit verde (git status, poi git restore), e rifai un pezzo solo |
| «Il test è verde, quindi è fatto» | Il test dice «fatto» per quello che controlla. Manca la prova in /docs | Prova la rotta a mano, e guarda cosa è cambiato nel database |
| Il progetto «funziona» ma non so a che punto sono | Non c'è un elenco dei pezzi, né commit che li raccontano | Il README.md («A che punto siamo»), e git log --oneline: un commit per pezzo |
Un 1 sparso in tre rotte, e nessuno si ricorda cosa vuol dire | Un valore finto senza nome, senza commento, in tre posti | Una costante con il suo commento FINTO, in un file solo. grep -rn FINTO app/ la ritrova |
| Una funzione «se avanza tempo» fatta prima delle tre indispensabili | L'ordine dei lavori non c'è, o non è stato seguito | Rimettila in fondo alla tabella: prima le tre funzioni, poi il login, poi il resto |
| Non so da dove ricominciare | Sei fermo troppo in alto | Il pezzo più piccolo: la rotta che risponde [], senza il database. Poi il database |
Gli errori della palestra
I test rossi che incontrerai di più negli esercizi.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
Un filtro che non trova niente non è un errore: 200 e una lista vuota | Hai risposto 404 a una lista che non ha trovato niente | Una lista si restituisce sempre, anche vuota. Il 404 è per «una cosa sola» (la scheda) |
Con due filtri servono tutte e due le condizioni | Il secondo filtro è ignorato: elif al posto di if | Un if per filtro |
La prenotazione non è nel database: c'è il db.commit()? | Hai usato db.flush() al posto di db.commit(), o non hai fatto il commit | db.commit(). flush manda i comandi, ma non conferma |
Lo slot è campo + giorno + ora | Nel controllo dello slot ti manca una delle tre condizioni | Tre condizioni nel where: campo, giorno, ora |
Il Campo 9 non esiste: prima db.get, e se è None il 404 | Hai scritto direttamente la prenotazione, e il database ha detto no con un ForeignKeyViolation | Il controllo del campo, prima del controllo dello slot |
La riga c'è ancora: manca db.commit()? | La disdetta non è stata confermata | db.commit() dopo db.delete(…) |
Con un 422 non si scrive niente | Hai scritto prima di controllare | I controlli prima della scrittura; per i 422 degli stampi se ne occupa FastAPI |
Le due scritture vanno insieme: la restituzione E lo stato dell'oggetto, con un commit solo | Manca la modifica dello stato, o hai scritto due commit | Cambia oggetto.stato, db.add(restituzione), un db.commit() solo |
Tutto il resto: il Pronto soccorso sul sito.