如何存储多源同文件？CachedNetworkImage缓存存取与命名机制

1. 如何存储来自其他源的相同文件？ #

默认情况下，flutter_cache_manager会根据图片的完整URL生成哈希值作为缓存标识，这会导致同一文件来自不同URL时，被当成不同缓存项重复存储。要实现按数字文件名统一缓存，你需要自定义CacheManager，重写缓存路径/标识的生成逻辑，用提取出的数字文件名作为唯一key，而非原URL。

举个实现示例：

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

class NumberFileNameCacheManager extends CacheManager {
  static const _cacheKey = 'number_file_cache';
  static NumberFileNameCacheManager? _instance;

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

  NumberFileNameCacheManager._internal() : super(Config(_cacheKey));

  @override
  Future<String> getFilePath(String url, {Map<String, String>? headers}) async {
    // 从URL中提取数字文件名（假设URL结尾格式为`xxx/1234.jpg`）
    final urlSegments = url.split('/');
    final fullFileName = urlSegments.last;
    final numberFileName = fullFileName.split('.').first;
    // 可添加校验逻辑，确保numberFileName为纯数字

    final cacheDir = await getTemporaryDirectory();
    // 用数字文件名+原后缀作为缓存文件名
    return p.join(cacheDir.path, _cacheKey, '$numberFileName${p.extension(url)}');
  }
}

使用时给CachedNetworkImage指定这个自定义缓存管理器：

CachedNetworkImage(
  imageUrl: 'https://source1.com/123.jpg',
  cacheManager: NumberFileNameCacheManager(),
  // 其他参数...
)

这样不管从哪个源加载同数字文件名的图片，最终都会存在同一个缓存文件里，读取时直接复用，不会重复下载存储。

2. 缓存中文件的存储与命名机制是怎样的？ #

默认机制 #

flutter_cache_manager的默认行为：

• 命名规则：对图片的完整URL进行MD5哈希，生成32位字符串作为缓存文件的文件名，不保留原文件名。
• 存储路径：缓存文件默认存在应用临时目录，比如Android为/data/data/[你的包名]/cache/flutter_cache_manager，iOS为Library/Caches/flutter_cache_manager。
• 元数据管理：同时维护一个本地SQLite数据库，存储缓存文件对应的URL、过期时间、文件大小、响应头元数据等，用于判断缓存有效性、是否需要更新。

自定义机制 #

如果重写了getFilePath方法，缓存文件的命名和路径完全由自定义逻辑控制——比如示例中直接用提取的数字文件名作为缓存文件名，存储在指定的缓存子目录下。

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