Flutter image_picker在iOS端选图时文件名与哈希值异常问题

核心原因：iOS沙盒机制 + image_picker的默认处理 #

• iOS相册处于应用沙盒之外，应用无法直接访问原始文件路径。image_picker在iOS端的逻辑是把选中的相册图片复制到应用临时目录，再返回这个临时文件的路径——这就是文件名总是image_pickerXXXXX.jpg的原因，临时文件由插件自动命名，和原始文件名无关。
• 哈希值每次不同的本质：iOS复制图片时，image_picker默认会做这些操作导致字节流变化：
  • 自动将HEIC格式图片转为JPG（iOS相册默认拍照格式为HEIC）；
  • 默认压缩图片质量（imageQuality参数默认不是100）；
  • 调整或移除隐私相关的EXIF元数据；
  • 图片编码过程中的细微差异（即使参数一致，部分编码步骤可能生成不同字节）。

这是iOS沙盒规则与插件默认配置共同作用的结果，既不是插件bug，也不算iOS相册的"默认行为"，而是应用访问外部资源的必然处理方式。

无需立刻自研插件，先尝试这些方案 #

1. 修改image_picker调用参数，减少自动处理 #

调整参数尽可能保留原始图片字节：

XFile? pickedFile = await picker.pickImage(
  source: ImageSource.gallery,
  imageQuality: 100, // 关闭压缩
  maxWidth: null, // 不缩放宽度
  maxHeight: null, // 不缩放高度
  requestFullMetadata: true, // 请求完整元数据
);

若相册内是HEIC格式图片，可强制保留原格式：

XFile? pickedFile = await picker.pickImage(
  source: ImageSource.gallery,
  imageQuality: 100,
  preferredAssetRepresentationMode: PreferredAssetRepresentationMode.current,
);

2. 改用pickMedia接口获取原始资源 #

pickMedia是image_picker 0.8.0+新增的接口，可返回更接近原始的媒体资源，还能拿到PHAsset ID，配合photo_manager插件获取原始文件：

final media = await picker.pickMedia();
if (media != null) {
  // 获取iOS专属的PHAsset ID
  final assetId = media.assetId;
  // 通过photo_manager根据ID获取原始文件
  final asset = await PhotoManager.getAssetById(assetId!);
  final file = await asset.file;
  if (file != null) {
    List<int> originalBytes = await file.readAsBytes();
    Digest digest = sha256.convert(originalBytes);
    // 后续处理逻辑
  }
}

3. 直接用photo_manager访问相册 #

如果前两种方案无法满足需求，可完全绕过image_picker，用photo_manager直接访问iOS相册的PHAsset，获取原始文件的路径和字节流，这样能100%拿到原始图片信息，哈希值会保持一致。

权限补充说明 #

iOS 14及以上版本，若需写入相册子文件夹，除已有的NSPhotoLibraryUsageDescription，建议添加NSPhotoLibraryAddUsageDescription权限描述，避免权限不足导致的文件保存失败。

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