Flutter CachedNetworkImage未自动清理临时存储缓存问题咨询

你遇到的问题核心在于CachedNetworkImage默认的缓存清理逻辑并非实时触发，而是仅在新增缓存文件时才会检查并删除过期或超限的文件。如果应用长时间没有新增缓存，超过30天的旧文件就会一直保留，最终导致缓存体积超标。

以下是具体的解决步骤：

1. 自定义缓存管理器，明确配置规则 #

CachedNetworkImage依赖flutter_cache_manager实现磁盘缓存，默认的DefaultCacheManager虽然有30天有效期和100MB上限的设置，但你可以自定义管理器来调整参数，并确保清理逻辑可靠：

import 'package:flutter_cache_manager/flutter_cache_manager.dart';

class CustomCacheManager extends CacheManager {
  static const _cacheKey = 'optimizedCachedImage';

  static CustomCacheManager? _instance;

  factory CustomCacheManager() {
    _instance ??= CustomCacheManager._internal();
    return _instance!;
  }

  CustomCacheManager._internal()
      : super(
          Config(
            _cacheKey,
            maxCacheSize: 200 * 1024 * 1024, // 设定200MB总缓存上限
            maxCacheAge: const Duration(days: 30), // 缓存文件有效期30天
            stalePeriod: const Duration(days: 7), // 7天未访问标记为过时文件
          ),
        );
}

然后在你的OptimizedCachedImage中指定这个自定义管理器：

return CachedNetworkImage(
  cacheManager: CustomCacheManager(), // 替换默认缓存管理器
  cacheKey: '$imageUrl-${finalWidth?.round()}x${finalHeight?.round()}',
  // 其他原有参数保持不变
);

2. 主动触发缓存清理 #

默认的清理逻辑只有在新增缓存时才运行，你可以在合适的时机主动调用清理方法，比如应用启动时、进入后台时：

// 清理所有过期缓存
CustomCacheManager().cleanup();

// 如果需要清空全部缓存（谨慎使用）
// CustomCacheManager().emptyCache();

可以把这个逻辑放在main函数初始化时，或者通过WidgetsBindingObserver监听应用生命周期，在应用从后台返回时触发清理。

3. 优化缓存键生成策略 #

你当前的cacheKey包含了尺寸信息，这会导致同一个图片的不同尺寸生成独立的缓存文件，大幅增加缓存总量。如果你的图片服务已经支持自适应尺寸，可以简化cacheKey为仅imageUrl；如果必须按尺寸缓存，建议限制允许的尺寸范围，避免生成过多冗余缓存。

4. 检查依赖版本 #

确保flutter_cache_manager使用的是最新稳定版，旧版本可能存在缓存清理逻辑的bug，升级到最新版可以避免一些已知问题。

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