Komga数据库连接超时与扫描性能下降问题分析

问题背景

Komga是一款优秀的漫画服务器软件，近期有用户报告在从1.11.0版本升级到1.20.0版本后出现了两个主要问题：登录时频繁出现错误以及扫描新书时间显著延长（从1-2分钟增加到45分钟以上）。这些问题主要出现在Raspberry Pi设备上，数据库存储在SD卡中。

问题表现

用户升级路径为1.11.0→1.15.0→1.20.0，每次升级后重启服务。主要症状包括：

1. 服务重启后首次登录需要多次尝试才能成功
2. 扫描25本新书的时间从1-2分钟延长到45分钟以上
3. 日志中频繁出现数据库连接超时错误（SQLTransientConnectionException）

根本原因分析

根据日志和用户反馈，可以确定问题主要由以下几个因素导致：

1. 数据库连接池资源不足：日志显示连接池中只有1个活跃连接，却有4个请求在等待，导致30秒超时。

2. 存储介质性能瓶颈：用户将数据库存储在SD卡上，这种存储介质在频繁I/O操作时性能较差，特别是对于SQLite这类需要频繁读写的小型数据库。

3. 内存配置不足：虽然未直接出现OutOfMemory错误，但Komga在运行时占用了约1GB内存，默认配置可能无法满足需求。

4. 版本升级带来的查询复杂度增加：新版本可能引入了更复杂的数据库查询，在资源受限的设备上表现更为明显。

解决方案

1. 增加JVM堆内存：通过添加-Xmx2g参数为Komga分配更多内存，这已被证实可以解决问题。

2. 优化数据库存储位置：

   • 将数据库迁移到SSD等高性能存储设备
   • 如果必须使用SD卡，选择高耐久性、高速度的型号

3. 调整数据库连接池配置：

   • 增加连接池大小
   • 调整连接超时时间

4. 监控资源使用情况：

   • 定期检查内存使用情况
   • 监控数据库响应时间

预防措施

1. 升级前评估：在主要版本升级前，评估设备资源是否满足新版本需求。

2. 分阶段升级：避免跨多个主要版本直接升级，采用渐进式升级策略。

3. 备份重要数据：升级前备份数据库和配置文件。

4. 性能基准测试：在非生产环境测试升级后的性能表现。

技术细节

SQLite在资源受限环境中的表现：

• 单文件数据库设计在频繁I/O时对存储介质性能敏感
• 写操作会导致整个数据库文件锁定
• 复杂查询可能产生临时表，增加内存和I/O压力

Komga的内存使用特点：

• 扫描过程需要加载和解析大量图像元数据
• 数据库查询结果缓存
• 图像处理缓冲区

总结

Komga在Raspberry Pi等资源受限设备上的性能表现很大程度上取决于存储介质和内存配置。通过合理调整JVM参数和优化数据库存储位置，可以显著改善性能问题。对于家庭用户和小型部署，建议至少为Komga分配2GB内存，并将数据库存储在SSD上以获得最佳体验。