Il problema
Il log applicativo mostra OperationalError: database is locked. Prima di riavviare tutto, occorre capire quali PID mantengono aperto il database e se una transazione resta attiva troppo a lungo.
Procedura di diagnostica
Si parte dai controlli non distruttivi, si identificano i processi o i servizi responsabili e soltanto dopo si interviene sulla configurazione. I percorsi e gli host riportati sono esempi da adattare al proprio ambiente.
lsof /opt/app/data/app.db /opt/app/data/app.db-wal /opt/app/data/app.db-shm
fuser -v /opt/app/data/app.db
systemctl status nome-app.service
journalctl -u nome-app.service --since '30 min ago' --no-pager
Interpretazione e soluzione
lsof e fuser mostrano chi ha file aperti, non quale transazione SQL detenga il lock. Incrocia i PID con i log applicativi e i tempi di connessione. In Python usa connessioni per processo/thread, un busy_timeout ragionevole e commit tempestivi. Non eseguire un kill indiscriminato sui processi e non eliminare i file WAL mentre la VM sta lavorando.
Checklist prima del rilascio
- Backup dei file interessati e verifica dello stato iniziale.
- Test del caso che ha generato l’errore, con log e timestamp verificabili.
- Applicazione graduale della modifica, controllo sintattico dove previsto e verifica dopo il riavvio.
- Rollback rapido se compare una regressione o un falso positivo.
Approfondimenti: GeoIP su Apache e debug redirect Apache.