Tiercel 下载任务中 URL 映射更新的缓存同步问题分析

背景介绍

Tiercel 是一个优秀的 Swift 下载框架，在 iOS 开发中被广泛使用。在实际开发中，开发者可能会遇到下载任务 URL 变更的情况，这时框架需要正确处理 URL 映射关系的更新和缓存同步。

问题现象

当下载任务的 currentURL 和原始 url 不同时，框架更新了 currentURL 后没有立即同步更新缓存。这会导致以下问题：

1. 应用重启后，缓存中保存的仍然是原始 url
2. 通过 URLSession 的 getTasksWithCompletionHandler(_:) 方法获取的下载任务请求 URL 是更新后的 currentURL
3. 由于缓存和实际请求 URL 不一致，框架无法正确匹配和恢复下载任务

技术原理分析

Tiercel 框架内部维护了一个 URL 映射表 (urlMapper)，用于记录下载任务当前 URL (currentURL) 和原始 URL (url) 的对应关系。这种设计允许下载任务在运行过程中变更 URL 而不影响任务标识。

问题出在缓存同步机制上：

1. 当 currentURL 更新时，框架更新了内存中的 urlMapper
2. 但缓存没有立即同步更新，而是等待下一次存储时机
3. 如果在这期间应用重启，内存中的 urlMapper 会丢失，只能从缓存恢复

解决方案

核心解决思路是在更新 URL 映射关系后立即同步缓存。具体实现如下：

internal func updateUrlMapper(with task: DownloadTask) {
    protectedState.write { $0.urlMapper[task.currentURL] = task.url }
    storeTasks() // 立即存储任务状态到缓存
}

这个修改确保了：

1. URL 映射关系的变更立即持久化
2. 应用重启后能正确恢复下载任务
3. 保持框架原有功能不变

最佳实践建议

1. 及时同步原则：关键状态的变更应该立即持久化，避免依赖后续的存储时机
2. 状态一致性：内存状态和持久化状态应保持一致，特别是在可能发生应用终止的场景
3. 异常处理：考虑在应用启动时检查并修复可能的状态不一致问题

总结

在下载框架设计中，URL 映射和状态持久化是关键功能点。Tiercel 通过立即同步缓存的优化，解决了 URL 变更场景下的任务恢复问题，提高了框架的健壮性。这个案例也提醒开发者，在状态管理设计中要考虑内存和持久化状态的一致性保障机制。