La cartella del progetto, se qualcosa va storto
Gli errori della cartella e i test rossi della palestra
Gli errori che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai. In ordine di quando capitano: prima l'ambiente, poi il database, poi il codice.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
command not found: pytest (o fastapi, pip) | Il venv è spento: il terminale non conosce i comandi che hai installato | source .venv/bin/activate, dalla cartella del progetto. Controlla con which python: deve nominare .venv. Se continua: pytest non parte, o non trova niente |
ModuleNotFoundError: No module named 'app' | Python non trova il pacchetto app/: pytest.ini manca, non ha pythonpath = ., o hai lanciato pytest da un'altra cartella | ls deve mostrare pytest.ini e app/. Se ci sono, apri il pytest.ini e controlla la riga pythonpath = . |
ModuleNotFoundError: No module named 'dotenv' (o fastapi, sqlalchemy, psycopg, httpx) | La libreria non è nel venv: venv spento, o manca pip install -r requirements.txt | Accendi il venv, poi pip install -r requirements.txt. Se il nome manca dal file, aggiungilo |
Path does not exist app/main.py (da fastapi dev) | Sei in un'altra cartella | cd nella cartella del progetto. fastapi dev app/main.py parte sempre da lì |
database "ritrovato" does not exist (dentro un OperationalError) | PostgreSQL c'è, ma non il database | createdb ritrovato, poi psql -d ritrovato -f schema.sql |
connection failed … No such file or directory | PostgreSQL è spento, o psycopg lo cerca nel posto sbagliato | Mac: brew services start postgresql@16. Se continua: export PGHOST=/tmp (WSL: /var/run/postgresql) |
relation "oggetti" does not exist (UndefinedTable) | Il database c'è, ma è vuoto: schema.sql non è mai stato caricato | psql -d ritrovato -f schema.sql |
column stazioni.linea does not exist (UndefinedColumn) | modelli.py ha una colonna che il database non ha: i due non coincidono | Rileggi schema.sql: comanda lui. Aggiungi la colonna lì (e rifai il database) oppure togli la riga dal modello |
Could not parse SQLAlchemy URL from given URL string | DATABASE_URL c'è, ma è vuota: nel .env c'è la riga senza il valore | cat .env: DATABASE_URL=postgresql+psycopg:///ritrovato, tutto attaccato |
null value in column "stato" of relation "oggetti" violates not-null constraint (NotNullViolation) | La colonna ha un DEFAULT in schema.sql, ma modelli.py non lo sa: SQLAlchemy ha mandato NULL | mapped_column(server_default="in deposito"), con il valore dello schema.sql |
Input should be a valid dictionary or instance of Oggetto (model_type) | Hai dato a Pydantic un oggetto OggettoDB, e lo stampo di risposta non sa leggere gli attributi | model_config = ConfigDict(from_attributes=True) nello stampo di risposta |
Input should be 'ombrelli', 'borse', … (literal_error) | Non è un guaio: è lo stampo che fa il suo lavoro. La categoria non è nella lista | Correggi il dato. Se la categoria deve esistere, aggiungila a schema.sql e al Literal |
404 Not Found su una rotta di un router | Il router c'è, ma main.py non lo monta | app.include_router(oggetti.router) in main.py. Guarda /docs: se la rotta non compare, non è montata |
git status mostra .env o .venv/ tra i file da salvare | Il .gitignore manca, o ha una riga scritta male | Controlla con git check-ignore -v .env. Se è già stato salvato in un commit: la storia lunga |
Nella palestra i test rossi parlano da soli; i più tipici:
| Il test dice | Vuol dire | Cosa fai |
|---|---|---|
Manca httpx: senza, il TestClient di FastAPI non parte | requirements.txt non ha tutte le librerie | Controlla il nome: tutto minuscolo, senza spazi, una libreria per riga |
Hai ignorato anche .env.example: il modello deve andare su GitHub | Nel .gitignore c'è .env* o un modello troppo largo | Una riga per il .env, esatta |
«…» sembra avere utente e password: nel modello non ci vanno | Hai copiato il .env vero | Il modello ha solo DATABASE_URL=postgresql+psycopg:///prenota_sala |
sale: schema.sql ha […], il modello ha […] | Le colonne di modelli.py non sono quelle (o non nell'ordine) di schema.sql | Una colonna, una riga, nello stesso ordine. Il messaggio ti mostra le due liste |
sale.note: in schema.sql può essere NULL (str | None) | Una colonna facoltativa scritta senza | None | Mapped[str | None] |
La sessione è rimasta aperta: get_db deve chiuderla alla fine | get_db apre la sessione senza il with | with Session(engine) as db: e yield db dentro |
NameError: name 'router' is not defined | Nell'esercizio 8 manca la riga router = … | Falla in sale.py, sopra la rotta |
PostgreSQL non risponde, quindi i test non possono partire | PostgreSQL è spento | Mac: brew services start postgresql@16 · WSL: sudo service postgresql start |
Gli errori che non danno errori
Il guaio di questo capitolo è il silenzio: il progetto parte, e fa la cosa sbagliata. Quattro modi in cui succede.
Il .env che nessuno legge. Un .env scritto male non dà errori: si usa il valore di riserva. Se il file si chiama env, o .env.txt, o sta in un'altra cartella, load_dotenv() non lo trova. Non si lamenta: database.py usa il valore di riserva. Il programma parte, su un database che forse non è quello che credi. Se il database «sembra vuoto», stampa DATABASE_URL:
python -c "from app.database import DATABASE_URL; print(DATABASE_URL)"I test che scrivono nel tuo database. Se nel conftest.py la riga con os.environ va dopo l'import dell'app, i test girano sul database del tuo .env, e tabelle_come_nuove ne butta le tabelle. Nessun errore: ti accorgi che i dati sono spariti. Controllo semplice: un dato di prova nel tuo database (INSERT), pytest, e il dato c'è ancora.
modelli.py che non copia schema.sql. Una colonna scritta Mapped[str] che nel database è facoltativa non dà nessun errore finché un giorno arriva una riga con NULL. I test della palestra (esercizio 6) fanno proprio questo confronto: nel tuo progetto, rileggi le due cose una accanto all'altra a ogni modifica.
Il .env già finito su Git. Il .gitignore non toglie quello che c'è già. git status non nomina il .env, perché è «già tracciato», ma ogni modifica finisce nei commit. Controllo: git ls-files non deve mai nominare .env. Se lo nomina: git rm --cached .env, e cambia la password (la storia la ricorda).
Se il problema non è la cartella
Connection refused, role "…" does not exist, pg_isready che dice no response: non è la cartella, è PostgreSQL, e se ne parla nel libro Il banco di lavoro. Se pytest non parte o non trova i test, il Pronto soccorso ha la cura.