Flutter聊天应用文件单次下载本地缓存方案咨询（无需第三方包）

核心逻辑 #

先通过文件唯一标识校验本地是否存在目标文件，存在则直接读取本地资源；不存在则发起流式下载，完成后写入本地并记录缓存信息，确保同一文件仅下载一次。

具体实现步骤 #

1. 获取本地存储路径（无第三方包） #

通过Flutter的MethodChannel调用原生API获取应用私有存储目录：

Android端原生代码（Kotlin）

class MainActivity : FlutterActivity() {
    private val CHANNEL = "com.yourchat.app/file_storage"
    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
            if (call.method == "getPrivateStoragePath") {
                val path = filesDir.absolutePath
                result.success(path)
            } else {
                result.notImplemented()
            }
        }
    }
}

iOS端原生代码（Swift）

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
  override func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    let controller = window?.rootViewController as! FlutterViewController
    let channel = FlutterMethodChannel(name: "com.yourchat.app/file_storage", binaryMessenger: controller.binaryMessenger)
    channel.setMethodCallHandler { (call, result) in
        guard call.method == "getPrivateStoragePath" else {
            result(FlutterMethodNotImplemented)
            return
        }
        let paths = NSSearchPathForDirectoriesInDomains(.documentDirectory, .userDomainMask, true)
        result(paths.first)
    }
    GeneratedPluginRegistrant.register(with: self)
    return super.application(application, didFinishLaunchingWithOptions: launchOptions)
  }
}

Dart端调用代码

import 'package:flutter/services.dart';

Future<String> getPrivateStoragePath() async {
  const platform = MethodChannel('com.yourchat.app/file_storage');
  try {
    return await platform.invokeMethod('getPrivateStoragePath');
  } on PlatformException catch (e) {
    throw Exception('获取存储路径失败: ${e.message}');
  }
}

2. 文件唯一标识与存储结构 #

• 用服务器返回的文件ID或文件MD5哈希值作为本地文件名，避免重名冲突
• 在存储根目录下创建chat_files子目录统一存放下载文件，同时维护cache_list.json记录缓存文件的元数据（文件ID、路径、大小、缓存时间）

3. 缓存校验与下载逻辑 #

使用Flutter原生HttpClient实现流式下载，避免大文件占用过多内存：

import 'dart:io';
import 'dart:convert';

// 检查文件是否已缓存
Future<bool> isFileCached(String fileId, String storageRoot) async {
  final fileDir = Directory('$storageRoot/chat_files');
  await fileDir.create(recursive: true);
  return File('${fileDir.path}/$fileId').exists();
}

// 流式下载文件并缓存
Future<String> downloadAndCacheFile(String fileUrl, String fileId, String storageRoot) async {
  final fileDir = Directory('$storageRoot/chat_files');
  await fileDir.create(recursive: true);
  final savePath = '${fileDir.path}/$fileId';

  // 先校验缓存
  if (await isFileCached(fileId, storageRoot)) {
    return savePath;
  }

  final client = HttpClient();
  try {
    final request = await client.getUrl(Uri.parse(fileUrl));
    final response = await request.close();
    if (response.statusCode != HttpStatus.ok) {
      throw Exception('下载失败，状态码: ${response.statusCode}');
    }

    // 流式写入文件
    final file = File(savePath);
    final sink = file.openWrite();
    await response.pipe(sink);
    await sink.close();

    // 记录缓存元数据
    await _saveCacheMetadata(fileId, savePath, await file.length());
    return savePath;
  } finally {
    client.close();
  }
}

// 保存缓存元数据到JSON文件
Future<void> _saveCacheMetadata(String fileId, String localPath, int fileSize) async {
  final cacheFile = File('${Directory(localPath).parent.path}/cache_list.json');
  List<Map<String, dynamic>> cacheList = [];
  
  if (await cacheFile.exists()) {
    cacheList = List<Map<String, dynamic>>.from(jsonDecode(await cacheFile.readAsString()));
  }

  // 移除旧数据，添加新记录
  cacheList.removeWhere((item) => item['fileId'] == fileId);
  cacheList.add({
    'fileId': fileId,
    'localPath': localPath,
    'fileSize': fileSize,
    'cacheTime': DateTime.now().toIso8601String()
  });

  await cacheFile.writeAsString(jsonEncode(cacheList));
}

4. 本地文件读取逻辑 #

根据文件类型选择对应方式读取：

// 获取本地文件
File getLocalFile(String fileId, String storageRoot) {
  return File('$storageRoot/chat_files/$fileId');
}

// 示例：加载本地图片
// Image.file(getLocalFile(fileId, storageRoot))

// 示例：打开本地文档（可通过MethodChannel调用原生文件打开能力）

5. 大文件优化要点 #

• 流式下载：通过response.pipe(sink)分块写入文件，避免一次性加载整个文件到内存
• 进度监听：可通过response.listen监听下载进度，更新UI：

int receivedBytes = 0;
final totalBytes = response.contentLength ?? 0;

response.listen(
  (chunk) {
    receivedBytes += chunk.length;
    final progress = (receivedBytes / totalBytes * 100).toStringAsFixed(2);
    // 更新下载进度UI
  },
  onDone: () => sink.close(),
  onError: (e) {
    sink.close();
    throw e;
  }
);

• 断点续传（可选）：如果服务器支持Range请求头，可记录已下载字节数，下次从断点处继续下载

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