SYSADMIN JOURNAL / Linux · Networking · Security · HostingProcedure, appunti e soluzioni tecniche
Mysql

SQLite: scoprire quale processo tiene aperto il database con lsof e fuser

Pubblicato il 18/11/2026

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.