Pi-hole数据库锁定问题分析与解决方案

问题现象

Pi-hole用户报告了DNS解析速度极慢甚至完全失败的情况。系统运行约15天后，不仅DNS服务响应迟缓，连Web管理界面也变得异常缓慢。检查日志发现大量"database is locked"错误信息，表明SQLite数据库出现访问冲突。

技术分析

日志显示Pi-hole的FTL引擎在尝试执行以下操作时遇到数据库锁定：

1. 通过IP地址查询MAC地址
2. 通过IP地址获取设备名称
3. 通过IP地址获取网络接口信息

这些操作都涉及对pihole-FTL.db数据库的访问，但SQLite报告数据库被锁定。典型错误示例如下：

SQLite3 message: database is locked in "SELECT hwaddr FROM network WHERE id = (SELECT network_id FROM network_addresses WHERE ip = ? GROUP BY ip HAVING max(lastSeen));" (5)

根本原因

数据库锁定通常由以下情况引起：

1. 并发访问冲突 - 多个进程/线程同时尝试写入数据库
2. 长时间运行的事务未提交
3. 系统资源不足导致操作超时
4. 存储设备I/O性能瓶颈

在Pi-hole环境中，最可能的原因是：

• FTL引擎与其他进程（如定期维护任务）的数据库访问冲突
• 虚拟机环境下的I/O延迟问题
• 长时间运行后数据库文件可能出现的损坏或碎片化

解决方案

临时解决方案

1. 重启DNS服务：

pihole restartdns

2. 重启Pi-hole FTL服务：

sudo systemctl restart pihole-FTL

长期解决方案

1. 优化数据库配置：

sudo sqlite3 /etc/pihole/pihole-FTL.db "PRAGMA journal_mode=WAL;"

2. 增加SQLite超时设置（需修改Pi-hole源代码）
3. 定期维护数据库：

sudo sqlite3 /etc/pihole/pihole-FTL.db "VACUUM;"

4. 对于虚拟机环境，确保：
   • 分配足够的虚拟CPU资源
   • 使用高性能存储后端
   • 禁用内存气球驱动等可能引起I/O延迟的功能

预防措施

1. 设置定期重启计划（如每周一次）
2. 监控数据库文件大小和I/O性能
3. 考虑使用更健壮的数据库后端（如MySQL）替代SQLite

技术背景

Pi-hole使用SQLite数据库存储网络设备信息、查询记录等数据。SQLite采用文件级锁机制，当写入操作发生时，整个数据库文件会被锁定。在高并发环境下，这种设计可能导致性能问题和锁定冲突。

WAL(Write-Ahead Logging)模式可以显著改善并发性能，它允许读取操作在写入发生时继续进行。对于Pi-hole这类需要同时处理大量查询和记录操作的服务，WAL模式是推荐的配置选项。