如何监控生产环境 SQLite 的连接数和锁等待状态

SQLite 是文件型数据库，不像 MySQL 或 SQL Server 那样有全局系统视图可以直接查询连接数和锁状态，生产环境监控主要依赖应用层的连接池统计和数据库本身的日志配置。

先说结论：监控 SQLite 连接和锁等待需要在应用层实现，数据库层需开启 WAL 模式以减少锁竞争。

命令速用版

SQLite 没有直接的 SHOW CONNECTIONS 命令，但可以通过 PRAGMA 配置优化锁行为，并在代码中读取连接池状态。

-- 开启 WAL 模式，允许读写并发
PRAGMA journal_mode=WAL;
-- 设置锁等待超时时间，单位毫秒
PRAGMA busy_timeout=60000;
-- 设置缓存大小，单位 KB（负值表示基于内存的 KB 数）
PRAGMA cache_size=-65536;

应用层监控示例（Python SQLAlchemy 异步连接池）：

active_connections = async_engine.pool.checkedout()
idle_connections = async_engine.pool.checkedin()

SQLite 的设计哲学是轻量、简单、零配置，默认的回滚日志模式采用了保守的锁机制。在默认模式下，写入期间对数据库文件进行排他锁，读写互斥，写操作会阻塞所有读操作。这就是为什么在高并发 Web 服务中容易遇到 database is locked 错误。

开启 WAL（Write-Ahead Logging）模式后，写操作写入 WAL 文件而非直接修改主数据库，读操作读取原始数据加 WAL 内容，从而实现读写并发。但连接数的监控依然依赖于应用程序如何管理数据库连接，因为 SQLite 本身没有独立的服务器进程来维护连接列表。

1. 配置数据库连接参数

在建立连接的初始化阶段，执行关键的 PRAGMA 设置。对于 Java 应用，可以在 SQLiteConfig 中配置；对于 Python 或 Node.js，通常在连接建立后的回调中执行。

关键配置包括 journal_mode=WAL 和 busy_timeout。busy_timeout 设置了一个等待锁释放的超时时间，避免请求立即失败。

2. 实现应用层连接池监控

根据使用的开发语言，利用驱动提供的接口监控连接池状态：

3. 启用性能指标收集

如果使用 WCDB 等增强库，可以获取核心监控指标，包括执行耗时（纳秒级精度）、页面读写次数以及锁等待时间。对于普通 SQLite 驱动，建议在代码中包裹数据库操作，记录执行耗时和异常信息。

1. 检查锁错误日志

观察应用日志，确认 database is locked 错误的频率是否显著降低。如果开启 WAL 后依然频繁出现，可能需要检查是否有长事务未提交。

2. 监控响应时间

对比配置前后的读写操作响应时间。在读多写少场景下，开启 WAL 后读取操作不应再被写入操作阻塞，响应时间应更加平稳。

3. 查看连接池状态

通过应用监控面板或日志输出，确认连接池的空闲连接数是否合理。如果活跃连接数持续接近最大连接限制，说明需要调整 pool_size 或优化查询效率。

1. WAL 文件无限增长

WAL 模式需要定期执行 checkpoint 将 WAL 内容写入主数据库。如果未正确配置自动 checkpoint，WAL 文件可能会变得很大，影响性能。

2. 网络文件系统不兼容

WAL 模式在某些网络文件系统（如 NFS）上可能不兼容，导致锁机制失效或数据损坏。生产环境建议将数据库文件放在本地磁盘。

3. 误用 MySQL 监控命令

不要尝试在 SQLite 中执行 show status like 'Innodb_row_lock_waits' 这类 MySQL 专属命令，SQLite 不支持系统视图查询锁等待统计。