Flutter使用image_picker选择HEIF/HEIC图片时iOS端崩溃问题求助

我之前也碰到过一模一样的问题，iOS选HEIF图片崩溃基本是因为旧版image_picker对HEIF格式的处理存在原生bug，或者没有自动转换格式导致解码出错。下面给你几个优先级从高到低的可行解决方案：

方案1：升级image_picker并使用新版API强制转JPG #

旧的getImage方法已经被官方废弃，新版API对HEIF的支持完善了很多。先把你的image_picker升级到最新稳定版（可以去pub.dev查看最新版本号），然后修改代码用新版的pickImage方法，同时指定强制输出为JPEG格式：

Future<void> _pickImage(ImageSource source) async {
  final ImagePicker picker = ImagePicker();
  // 调用新版pickImage方法，强制转换为JPEG格式
  final XFile? pickedFile = await picker.pickImage(
    source: source,
    imageFormat: ImageFormat.jpeg, // 这一步会自动把HEIF转成JPG，避免崩溃
  );

  setState(() {
    if (pickedFile != null) {
      _imageFile = File(pickedFile.path);
      _file = null;
    } else {
      print('No se ha seleccionado ningún archivo.');
    }
  });
}

这个方法最直接，既能解决崩溃问题，还能统一后续处理的图片格式，省去单独兼容HEIF的麻烦。

方案2：如果需要保留HEIF格式（不转换） #

如果你必须直接处理HEIF图片，那需要确保iOS项目的基础配置没问题：

• 确认iOS部署目标至少是iOS 11.0（HEIF格式从iOS 11开始正式支持）
• 检查Info.plist里的相册权限是否正确配置（你选JPG正常的话这个应该没问题，但可以再确认下）：

<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问相册选择图片</string>

另外一定要保证image_picker是最新版，新版修复了不少HEIF相关的原生bug。

方案3：手动转换HEIF为JPG（备用方案） #

如果上面两种方法都没解决问题，可以用第三方库手动转换图片格式，推荐用flutter_image_compress：

1. 先在pubspec.yaml里添加依赖：

dependencies:
  flutter_image_compress: ^1.1.0 # 可以替换为最新版本

2. 修改代码，获取图片后立即转换格式：

import 'package:flutter_image_compress/flutter_image_compress.dart';

Future<void> _pickImage(ImageSource source) async {
  final ImagePicker picker = ImagePicker();
  final XFile? pickedFile = await picker.pickImage(source: source);

  if (pickedFile != null) {
    // 将HEIF图片转换为JPG，替换原路径的后缀为jpg
    final convertedFile = await FlutterImageCompress.compressAndGetFile(
      pickedFile.path,
      pickedFile.path.replaceAll(RegExp(r'\.heic$', caseSensitive: false), '.jpg'),
      format: CompressFormat.jpeg,
      quality: 85, // 可根据需求调整图片质量
    );

    setState(() {
      if (convertedFile != null) {
        _imageFile = convertedFile;
        _file = null;
      } else {
        print('图片转换失败');
      }
    });
  } else {
    print('No se ha seleccionado ningún archivo.');
  }
}

备注：内容来源于stack exchange，提问作者aws will