关于Flutter CachedNetworkImage持久化缓存的技术问询

1. 关闭应用/关机重启后缓存是否会被清除？ #

默认情况下，不会被清除。CachedNetworkImage依赖的flutter_cache_manager（默认使用DefaultCacheManager）会将图片缓存到设备的应用专属存储目录中，这类目录的文件不会因应用退出、设备关机或重启而被系统自动删除。

但存在两种例外情况：

• 当设备存储空间不足时，系统可能自动清理应用的缓存目录（Android的getCacheDir、iOS的Caches目录）以释放空间；
• 用户手动在系统设置中清除应用缓存数据时，缓存的图片会被删除。

2. 如何实现缓存永久保留至用户手动清除？ #

要让缓存不受系统自动清理影响，需修改缓存存储路径至应用的持久化存储目录（而非缓存目录），同时自定义缓存管理规则，具体操作如下：

步骤1：自定义CacheManager #

创建自定义缓存管理器，指定存储路径为应用的文档目录（该目录数据不会被系统自动清理，仅在用户卸载应用或手动删除应用数据时才会被移除）：

import 'package:flutter_cache_manager/flutter_cache_manager.dart';
import 'package:path_provider/path_provider.dart';
import 'package:path/path.dart' as path;

class PermanentCacheManager extends CacheManager {
  static const key = 'permanentImageCache';

  static PermanentCacheManager? _instance;

  factory PermanentCacheManager() {
    _instance ??= PermanentCacheManager._();
    return _instance!;
  }

  PermanentCacheManager._()
      : super(
          Config(
            key,
            stalePeriod: const Duration(days: 365), // 设置极长过期时间，避免自动清理
            maxNrOfCacheObjects: 1000, // 根据需求调整最大缓存数量
            repo: JsonCacheInfoRepository(databaseName: key),
            fileSystem: IOFileSystem(
              getApplicationDocumentsDirectory().then((dir) =>
                  path.join(dir.path, key)),
            ),
          ),
        );
}

步骤2：在CachedNetworkImage中使用自定义缓存管理器 #

替换默认的cacheManager参数，使用上述自定义管理器：

CachedNetworkImage(
  imageUrl: '你的Firebase Storage图片URL',
  cacheManager: PermanentCacheManager(),
  placeholder: (context, url) => const CircularProgressIndicator(),
  errorWidget: (context, url, error) => const Icon(Icons.error),
);

步骤3：添加手动清除缓存功能 #

在应用内设置页面等位置提供手动清除缓存的入口，调用缓存管理器的清理方法：

ElevatedButton(
  onPressed: () async {
    await PermanentCacheManager().emptyCache();
    // 可添加缓存已清除的提示逻辑
  },
  child: const Text('清除图片缓存'),
);

注意事项 #

• 存储到文档目录的缓存图片会随应用卸载一同被删除；
• 需合理设置maxNrOfCacheObjects和stalePeriod，避免过度占用用户设备存储空间；
• 确保Firebase Storage的图片URL持久有效（比如使用无签名公开URL或长期有效签名URL），否则缓存的图片可能无法正常加载。

内容的提问来源于stack exchange，提问作者hazem saad