Flutter image_picker在iOS端无法选中部分图片 webp格式无报错如何处理

• image_picker底层对不支持的图片格式没有做异常向上抛出的逻辑，选中webp等不兼容格式时会直接静默失败，上层try-catch无法捕获到对应错误。
• 不同系统版本的原生相册选择器本身对webp的支持度存在差异，低版本安卓、未做兼容配置的iOS系统，选中webp时都会出现无响应的情况。
• 超时方案不适用的核心原因是pickImage返回的Future只有在用户主动完成选择/取消选择操作时才会更新状态，用户停留在相册浏览页时Future长期处于pending状态，固定时长的超时必然会出现误判。

方案1：前置过滤不支持的格式（推荐） #

直接在调用选择器时指定允许的图片格式，让系统相册直接隐藏webp等不兼容的文件，用户无法选中，从根源避免问题，安卓端直接通过allowedMimeTypes参数配置即可：

try {
  final XFile? image = await _picker.pickImage(
      source: ImageSource.gallery,
      // 仅允许选择jpeg、png、gif三类常见支持的格式，可按需增减
      allowedMimeTypes: ['image/jpeg', 'image/png', 'image/gif']
  );
  if (image != null) {
    print(image.path);
  }
} catch (e) {
  print(e);
}

方案2：选中后做格式校验 #

如果需要允许用户选择所有格式，在拿到选中的文件后立刻做格式校验，发现不支持的格式主动提示用户：

try {
  final XFile? image = await _picker.pickImage(source: ImageSource.gallery);
  if (image != null) {
    final String path = image.path.toLowerCase();
    // 校验文件后缀，可根据业务需求扩展不支持的格式列表
    if (path.endsWith('.webp')) {
      // 此处自行实现用户提示逻辑，比如toast、弹窗提示
      print("暂不支持webp格式图片，请选择其他图片");
      return;
    }
    // 校验通过后再执行后续业务逻辑
    print(image.path);
  }
} catch (e) {
  print(e);
}

如果需要更严谨的校验，避免用户修改后缀名绕过检测，可以读取文件前几个字节的魔数判断真实的文件格式。

方案3：兼容webp格式 #

如果业务需要支持webp格式选中，做对应平台的兼容配置即可：

• 安卓端：在android/app/build.gradle中添加glide的webp支持依赖，image_picker安卓底层依赖glide做图片解析，添加依赖后即可正常识别webp格式。
• iOS端：在ios/Podfile中添加SDWebImage的webp子依赖，升级image_picker到最新稳定版即可支持webp格式选中。

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