SQLAlchemy: se qualcosa va storto
Gli errori delle classi-tabella, uno per uno
Questo è il capitolo dove molti si bloccano: i nomi si assomigliano (TrenoDB, Treno, TrenoNuovo), gli errori hanno nomi lunghi, e il database sta dietro un altro strato. Niente panico: quasi tutti gli errori sono questi. Ognuno qui sotto è stato provato davvero.
Ricorda come si legge un errore: dal basso. L'ultima riga dice cosa; il resto dice dove. Tutto è nel capitolo Leggere un traceback.
Gli errori delle classi
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
TypeError: 'carrozze' is an invalid keyword argument for TrenoDB | Hai dato al costruttore un nome che non è una colonna della classe | Guarda modelli.py: i nomi validi sono quelli degli attributi. Un refuso? carrozze per vagoni? |
AttributeError: type object 'TrenoDB' has no attribute 'codici' | Hai scritto male il nome di una colonna (qui codici invece di codice) | Ricopia il nome da modelli.py. VS Code te lo suggerisce se scrivi TrenoDB. e aspetti |
ArgumentError: Column expression, FROM clause, or other columns clause element expected, got <class 'stampi.Treno'>. | Hai messo uno stampo in select(...). select vuole una classe-tabella | select(TrenoDB), con DB |
NoInspectionAvailable: No inspection system is available for object of type <class 'pydantic._internal._model_construction.ModelMetaclass'> | Hai dato uno stampo a un'operazione della sessione (qui db.get(Treno, 1)). La sessione vuole una classe-tabella | db.get(TrenoDB, 1) |
FastAPIError: Invalid args for response field! Hint: check that <class 'modelli.TrenoDB'> is a valid Pydantic field type. | Nella freccia della rotta hai scritto -> TrenoDB. La risposta è uno stampo: FastAPI si ferma già all'avvio | -> Treno. Nelle frecce e nei parametri, gli stampi |
ValidationError ... Input should be a valid dictionary or instance of TrenoNuovo | Hai riempito con model_validate uno stampo che non ha from_attributes, partendo da un oggetto | Usa lo stampo della risposta (Treno), che ha model_config = ConfigDict(from_attributes=True) |
La freccia -> TrenoDB e il select(Treno) sono lo stesso sbaglio in due posti: una classe di un mondo dove ne serve una dell'altro. Quando non sai quale, chiediti: parla Pydantic (che controlla i dati) o parla il database? Nel primo caso uno stampo, nel secondo la classe con DB.
Gli errori della classe che non coincide con la tabella
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
ArgumentError: Mapper Mapper[PannelloDB(pannelli)] could not assemble any primary key columns for mapped table 'pannelli' | La classe non ha nessuna colonna con primary_key=True | Una colonna con mapped_column(primary_key=True): di solito id |
InvalidRequestError: Class ... does not have a __table__ or __tablename__ specified and does not inherit from an existing table-mapped class. | Manca __tablename__ | Aggiungi __tablename__ = "nome_della_tabella" |
NoReferencedTableError: Foreign key associated with column 'pannelli.stazione_id' could not find table 'stazione' ... | ForeignKey("stazione.id") punta a una tabella che non esiste: la tabella si chiama stazioni | Il nome è quello di __tablename__: ForeignKey("stazioni.id") |
ProgrammingError: (psycopg.errors.UndefinedColumn) column treni.colore does not exist | La classe ha una colonna (colore) che nel database non c'è. Comanda il database | O togli la colonna dalla classe, o la aggiungi alla tabella con SQL (ALTER TABLE). La classe non cambia la tabella |
L'ultimo è la lezione del capitolo: la classe descrive, il database comanda. Se la classe dice una cosa e il database un'altra, l'errore compare solo quando fai la domanda: SQLAlchemy scrive SELECT treni.id, treni.codice, treni.colore e PostgreSQL risponde che colore non esiste. Con echo=True vedi proprio quella riga.
Gli errori della strada (l'engine)
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
NoSuchModuleError: Can't load plugin: sqlalchemy.dialects:postgres | Nell'indirizzo hai scritto postgres://. Il nome del database per SQLAlchemy è postgresql | postgresql+psycopg:///nome_del_database |
OperationalError: (psycopg.OperationalError) connection failed: ... FATAL: database "db_che_non_esiste" does not exist | Il database con quel nome non c'è. Il nome sbagliato (o la variabile MENTA_DB) | createdb db_sqlalchemy, poi psql -d db_sqlalchemy -f linea_menta.sql. Controlla il nome in database.py |
PostgreSQL non risponde, quindi i test non possono partire. | PostgreSQL è spento, o psycopg non trova il socket. Il resto del messaggio dice quale dei due: connection failed: ... No such file or directory | Mac: brew services start postgresql@16. WSL: sudo service postgresql start. Se è acceso: export PGHOST=/tmp (Mac) o export PGHOST=/var/run/postgresql (WSL) |
ModuleNotFoundError: No module named 'modelli' | Hai lanciato un file che sta fuori da palestra/: Python cerca modelli.py accanto al file | Metti il tuo file dentro palestra/ e lancia python palestra/prova.py |
ModuleNotFoundError: No module named 'sqlalchemy' | Il venv è spento, o manca pip install | source .venv/bin/activate, poi pip install -r requirements.txt |
Il terminale che scrive troppo
Con echo=True ogni query riempie il terminale. È voluto: è lo strumento per vedere cosa fa SQLAlchemy. Le prime tre domande dopo l'avvio (select pg_catalog.version(), select current_schema(), show standard_conforming_strings) le fa una volta sola, per scoprire che database ha davanti: sono normali.
Per capire un errore, parti dall'ultima riga di traceback e dalle righe INFO ... Engine subito prima: l'ultima query scritta è quella che ha fatto storcere il naso al database.
Errori che non danno errori
Qualche confusione non fa fermare niente.
km che resta None. Crei TrenoDB(codice="M30", vagoni=5, in_servizio=True) e pensi che km valga 0 perché il database ha DEFAULT 0. Per l'oggetto, finché non è salvato, km è None.
Il refuso in un test della palestra. Se una risposta in risposte.py ha lo stesso valore ma con il tipo sbagliato ("6" invece di 6), il test dice solo «non è quello che c'è nel modello». Guarda se hai messo le virgolette dove non servono.
I tre puntini. Manca la risposta: al posto dei tre puntini (...) scrivi la tua. Non è un errore del modello: c'è ancora il segnaposto ... in risposte.py.
Se il problema non è il codice
pytest: command not found, No module named pytest, il pannello Testing vuoto: non è il tuo codice, è l'ambiente. Ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente.