Kingfisher图片缓存库中的目录检查死锁问题分析

问题背景

在iOS应用开发中，Kingfisher作为一款优秀的图片加载和缓存库被广泛使用。近期在Kingfisher 7.12.0版本中发现了一个较为罕见的死锁问题，主要发生在应用启动阶段，涉及图片缓存目录检查的同步操作。

问题现象

该问题表现为应用启动时偶尔会出现卡死现象，触发系统看门狗机制(WatchDog)导致应用崩溃。崩溃堆栈显示线程阻塞在maybeCachedCheckingQueue.sync操作上，具体是在执行contentsOfDirectory方法时发生超时。

技术分析

根本原因

1. 同步队列阻塞：Kingfisher使用一个串行队列maybeCachedCheckingQueue来同步检查缓存目录内容，当目录中文件数量较多时(如900+)，contentsOfDirectory操作可能耗时较长。

2. 系统版本因素：问题主要集中在iOS 15和16系统上，这些系统版本对文件系统操作的性能可能有所变化。

3. 缓存配置影响：当开发者设置了较大的磁盘缓存限制(如1GB)且应用长期运行积累了较多缓存文件时，问题更容易出现。

典型堆栈特征

崩溃线程通常显示为：

• 主线程等待DispatchQueue.sync调用返回
• 工作线程卡在FileManager.contentsOfDirectory系统调用
• 最终因超时被系统看门狗终止

解决方案

Kingfisher团队在后续版本中对该问题进行了修复，主要改进点包括：

1. 异步化处理：将原本同步的目录检查操作改为异步方式，避免阻塞工作队列。

2. 超时机制：为可能耗时的文件系统操作添加合理的超时处理。

3. 性能优化：减少不必要的目录遍历操作，优化缓存检查逻辑。

最佳实践建议

对于仍在使用Kingfisher 7.x版本的用户：

1. 升级建议：尽可能升级到Kingfisher 8.3.1或更高版本，该版本已包含完整修复。

2. 临时解决方案：若无法立即升级，可考虑以下措施：

   • 适当减小磁盘缓存大小限制
   • 定期清理过期缓存文件
   • 在应用启动时延迟加载图片缓存

3. 监控措施：在生产环境中监控以下指标：

   • 缓存目录中的文件数量
   • 缓存检查操作的耗时
   • 看门狗超时事件的发生频率

总结

文件系统操作在移动应用中往往是性能敏感点，特别是在同步上下文中。Kingfisher的这次修复提醒我们，即使是优秀的第三方库也需要持续关注其性能表现，特别是在系统版本更新和长期运行积累大量数据的情况下。开发者应当定期评估依赖库的版本更新，及时应用重要修复。