Pi-hole数据库损坏导致查询日志空白的解决方案

问题现象

在Pi-hole网络广告过滤系统中，用户报告了一个关于查询日志功能异常的问题。具体表现为：查询日志界面在正常运行一段时间（24-48小时）后会突然变为空白，不再显示任何DNS查询记录。此时虽然首页的统计图表仍能正常显示请求数据，但查询日志和高级过滤功能均失效。只有通过重启设备才能暂时恢复功能。

问题分析

通过检查系统日志，发现根本原因是Pi-hole的FTL数据库文件（pihole-FTL.db）出现损坏。主要错误信息包括：

1. 数据库损坏警告：系统检测到数据库文件已损坏无法使用
2. 事务处理失败：系统无法在现有事务中启动新事务
3. SQL查询执行错误：BEGIN TRANSACTION IMMEDIATE语句执行失败

这些错误表明数据库文件可能由于以下原因之一而损坏：

• 系统异常关机或断电导致数据库写入不完整
• 存储设备存在物理损坏或文件系统错误
• 并发访问冲突导致数据库锁定异常

解决方案

对于此问题，建议按照以下步骤进行修复：

1. 首先停止Pi-hole的FTL服务：

   systemctl stop pihole-FTL
   

2. 备份当前损坏的数据库文件（以防需要恢复）：

   sudo mv /etc/pihole/pihole-FTL.db /etc/pihole/pihole-FTL.db.bck
   

3. 重新启动FTL服务，系统会自动创建新的数据库文件：

   systemctl start pihole-FTL
   

预防措施

为防止问题再次发生，建议采取以下预防措施：

1. 定期检查文件系统：使用fsck工具检查存储设备是否有错误
2. 确保正常关机：避免直接断电，使用正确的关机流程
3. 监控数据库健康：定期检查Pi-hole日志中的数据库相关错误
4. 设置自动备份：为数据库文件设置定期备份机制

技术背景

Pi-hole使用SQLite数据库来存储DNS查询记录和网络设备信息。SQLite虽然是轻量级数据库，但在高并发写入场景下可能出现事务冲突。特别是在Raspberry Pi等资源有限的设备上，当系统负载较高时，数据库操作可能无法正常完成，导致文件损坏。

结论

数据库损坏是Pi-hole系统中一个已知但较少见的问题。通过上述解决方案可以快速恢复功能。如果问题频繁发生，则可能表明底层存储设备存在问题，需要考虑更换更可靠的存储介质或优化系统配置。对于普通用户而言，定期维护和正确操作是保持Pi-hole稳定运行的关键。