Depends, da zero, se qualcosa va storto
Gli errori di Depends, e quelli che non fanno rumore
Gli errori che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai.
Ricorda come si legge un traceback: dal basso. L'ultima riga dice cosa, la riga con in <module> o in nome_funzione dice dove. Tutto il resto è nel capitolo Leggere un traceback. Con un server acceso, il traceback è nel terminale del server, non in quello di curl.
Il codice
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
HTTPException: 401: Chiave sbagliata (o Manca la chiave) mentre il programma si accende, con la riga in <module> | Hai scritto Depends(controlla_chiave()): con le parentesi Python chiama il controllore subito, prima di qualunque richiesta, e il suo raise scatta all'avvio | Depends(controlla_chiave), senza parentesi |
{"detail":[{"type":"missing","loc":["query","programma"],"msg":"Field required","input":null}]} | Il parametro della rotta non ha = Depends(…): per FastAPI è un parametro della query | programma: str = Depends(controlla_chiave) |
TypeError: <generator object get_db at 0x…> is not a callable object | Depends(get_db()), con le parentesi su una dipendenza con yield: hai chiamato la funzione e hai dato a FastAPI un generatore | Depends(get_db) |
{"programma":null,…}, risposta 200 | La dipendenza non ha return: restituisce None, e il parametro della rotta vale None | Ricontrolla l'ultima riga del controllore: return del valore che serve |
{"detail":"Chiave sbagliata"} quando la chiave non la mandi | Manca il primo if chiave is None: senza header il confronto con la chiave giusta fallisce, e il messaggio è quello sbagliato | Il caso None va controllato prima |
{"detail":"Chiave sbagliata"} con la chiave giusta | In Header(…) manca l'alias="X-API-Key": FastAPI cerca un header che si chiama come il parametro, e non lo trova | Header(default=None, alias="X-API-Key") |
{"detail":[{"type":"missing","loc":["header","X-API-Key"],…}]} (422) | In Header(…) manca default=None: senza, l'header è obbligatorio e FastAPI risponde 422 prima che il tuo messaggio esca | Header(default=None, alias="X-API-Key") |
KeyError: 'abc123' nel terminale del server, e 500 Internal Server Error per il client | Nel controllore cerchi la chiave con le quadre: CHIAVI[chiave]. Se non c'è, KeyError | CHIAVI.get(chiave), poi if … is None: con il 401 |
| La rotta risponde 200 anche senza chiave | Il parametro Depends manca da quella rotta, o il router non ha dependencies | Ricontrolla ogni rotta: il test dice quale |
assert 501 == 200 | C'è ancora la riga «da fare»: raise HTTPException(status_code=501, …) | Al posto di quella riga, il tuo codice |
ERROR collecting palestra/test_….py e un'eccezione dal tuo file | Il file non si legge nemmeno: un errore a livello del modulo (le parentesi di Depends, un nome sbagliato) | Leggi l'ultima riga dell'errore, poi la riga in <module> |
AttributeError: module 'orologio' has no attribute 'adesso' | Nel file manca la funzione adesso che il test vuole sostituire | Scrivila: def adesso() -> datetime: |
Address already in use | C'è già un server acceso, in un altro terminale | Ctrl+C di là, oppure fastapi dev … --port 8001 |
Quelli che non fanno rumore
Sono i più antipatici: il programma funziona, e fa la cosa sbagliata.
- Il controllo copiato e dimenticato. Hai tre rotte e due controlli. Nessun errore: la terza risponde a tutti. Nei test si vede (200 invece di 401), a mano no.
- Il
returnmancante."programma": null. Il controllore decide bene, ma la rotta riceveNone. - Il valore che la rotta non usa. Se hai un parametro
fornitoree non lo leggi mai, il programma funziona, ma stai chiedendo un valore che non ti serve. Mettidependencies=[Depends(…)]nel decoratore. - Il controllo che dà un 404 al posto di un 401. Se per le rotte che non esistono dici 404 anche a chi non ha la chiave, racconti a un estraneo cosa c'è e cosa no. Con la dipendenza nel router, il 401 arriva per primo, e ti sei già coperto.
Le chiavi
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
401 con la chiave giusta, in Postman | L'header non parte: Authorization → API Key non è impostato, oppure il nome non è esattamente X-API-Key, oppure Add to non è Header | Controlla la scheda Headers della richiesta: deve esserci X-API-Key con il valore |
/docs mostra il campo X-API-Key vuoto e la rotta risponde 401 | Il campo si compila a mano: la chiave non la mette /docs da solo | Scrivi la chiave nel campo, poi Execute |
| La chiave è finita su GitHub | Era scritta nel codice, o nel .env senza .gitignore | Cambiala: una chiave pubblicata è bruciata, anche se cancelli il commit. Vedi le trappole del capitolo 2 |
Tutto il resto: il Pronto soccorso sul sito.