Flutter_Cache_Manager未按设置过期时间删除缓存文件原因咨询

现象是否正常？ #

这个现象是正常的，因为flutter_cache_manager的过期机制并非主动实时删除过期文件，而是依赖特定触发时机执行清理。

为何出现此情况？ #

核心原因有两点：

• stalePeriod 仅定义文件被标记为「过期」的时间，而非立即删除的时间。过期文件不会自动消失，只是后续请求时会被判定为过期，触发重新下载（可通过参数调整）。
• 你每次调用CacheManager(Config(...))都会创建新的缓存管理器实例，而清理过期文件的逻辑由管理器内部的定时任务或阈值触发逻辑执行，频繁创建新实例会导致清理任务无法正常运转。

缓存文件何时会被删除？ #

过期文件的删除通常在以下场景触发：

• 缓存管理器启动时，会自动检查并清理过期文件（前提是复用同一个管理器实例）。
• 当缓存文件数量超过Config中配置的maxNrOfCacheObjects阈值时，会触发清理逻辑，删除过期文件及多余文件。
• 手动调用清理方法：调用cacheManager.emptyCache()可删除所有缓存，调用cacheManager.removeFile(imageUrl)可删除单个指定文件，或调用cacheManager.cleanUp()主动清理所有过期文件。

工作机制说明 #

flutter_cache_manager的核心缓存逻辑：

1. 缓存存储：文件会被存储在由Config的key（此处为"images"）标识的专属缓存目录，同时记录每个文件的元数据（创建时间、过期时间等）。
2. 过期判断：调用getSingleFile或getFileFromCache时，会对比文件创建时间与stalePeriod：
   • 未过期则直接返回本地缓存文件；
   • 已过期则默认重新下载文件并覆盖旧缓存（可通过allowStale参数允许返回过期文件）。
3. 清理策略：缓存不会实时自动删除过期文件，而是通过启动检查、阈值触发或手动调用的方式，批量清理标记为过期的文件，以释放存储空间。

修复建议 #

• 复用缓存管理器实例：不要每次请求都创建新实例，全局维护一个单例：

final cacheManager = CacheManager(Config("images", stalePeriod: const Duration(minutes: 3)));

后续所有缓存操作都使用该单例，确保内部清理任务正常执行。

• 主动触发清理：若需要立即清理过期文件，可手动调用：

await cacheManager.cleanUp();

内容的提问来源于stack exchange，提问作者Uraam Asif