Flutter file picker选中同名不同图片路径不唯一如何处理？

file_picker选中文件时会默认将文件副本存到应用临时缓存目录，直接使用原文件名称命名缓存文件。当选中多个同名文件时，后选中的文件会直接覆盖缓存目录中已存在的同名文件，最终导致返回的路径重复，读取到的文件内容异常，上传到服务器后也会出现同名覆盖问题。

1. 直接读取文件字节流，规避缓存路径依赖 #

选中文件时开启withData参数，直接将文件内容读取到内存中，不依赖临时缓存路径，避免后续同名文件覆盖缓存导致内容错误。上传时自定义传递给服务器的文件名即可。

final result = await FilePicker.platform.pickFiles(
  type: FileType.image,
  allowMultiple: true,
  withData: true, // 直接加载文件字节到内存
);
if (result != null) {
  for (var platformFile in result.files) {
    // 直接获取文件字节，不需要读取本地路径
    final fileBytes = platformFile.bytes;
    // 生成唯一文件名，示例用时间戳拼接原文件名
    final uniqueFileName = '${DateTime.now().millisecondsSinceEpoch}_${platformFile.name}';
    // 直接传入字节和自定义文件名调用上传接口即可
  }
}

注：如果选中的单文件大小超过10M，不建议开启withData，避免内存溢出，改用下面的自定义存储路径方案。

2. 自定义本地存储路径，彻底解决路径重复问题 #

将选中的文件立刻复制到应用私有目录，使用唯一命名规则重命名文件，完全脱离file_picker的临时缓存机制，从根源避免路径重复和缓存覆盖问题。

import 'dart:io';
import 'package:path_provider/path_provider.dart';

// 文件选中后的处理逻辑
if (result != null) {
  // 获取应用私有文档目录，不会被系统自动清理
  final appDocDir = await getApplicationDocumentsDirectory();
  for (var platformFile in result.files) {
    final originalCacheFile = File(platformFile.path!);
    // 生成唯一文件名，也可使用UUID生成更稳妥的唯一标识
    final uniqueFileName = '${DateTime.now().microsecondsSinceEpoch}_${platformFile.name}';
    // 复制文件到自定义路径
    final savedFile = await originalCacheFile.copy('${appDocDir.path}/$uniqueFileName');
    // 后续直接使用savedFile的路径做上传或本地存储使用
  }
}

3. 上传接口适配 #

使用文件路径上传时，需要主动修改传给服务器的文件名参数，避免服务器侧因为接收的文件名相同导致覆盖，以Dio上传为例：

import 'package:dio/dio.dart';

FormData uploadForm = FormData.fromMap({
  'file': await MultipartFile.fromFile(
    savedFile.path, // 自定义路径的本地文件
    filename: uniqueFileName, // 主动指定传给服务器的文件名，不要用原文件名
  ),
});
await Dio().post('上传接口地址', data: uploadForm);

• 选中文件后要立刻处理字节或复制到自定义路径，不要长时间依赖file_picker返回的临时缓存路径，缓存文件随时可能被系统或后续选中的同名文件覆盖
• 不需要本地留存的临时文件，上传完成后建议主动删除，避免占用用户设备存储空间
• 除时间戳外，也可使用UUID生成唯一文件名，避免同一毫秒选中多个同名文件的极端冲突情况

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