Expo ImagePicker安卓设备content:// URI报错问题求助

问题原因 #

Android 7.0（API24）引入了FileProvider机制，第三方应用（如WhatsApp）存储的图片会通过content://格式的URI对外提供，而非传统的file://本地路径。expo-image-picker在部分旧设备上未自动处理这类URI，导致抛出Uri lacks 'file' scheme错误。

可行解决方法 #

1. 用expo-file-system转换Content URI为可访问的File URI #

借助expo-file-system将content://开头的文件复制到应用缓存目录，生成file://格式的路径供后续使用，同时支持多选场景下的单图错误处理：

import * as ImagePicker from 'expo-image-picker';
import * as FileSystem from 'expo-file-system';

async function selectImages() {
  const pickerResult = await ImagePicker.launchImageLibraryAsync({
    mediaTypes: ImagePicker.MediaTypeOptions.Images,
    allowsMultipleSelection: true,
    quality: 0.8,
  });

  if (pickerResult.canceled) return;

  // 批量处理选中的图片
  const processedAssets = await Promise.all(
    pickerResult.assets.map(async (asset) => {
      try {
        if (asset.uri.startsWith('content://')) {
          // 生成唯一的缓存文件名，避免冲突
          const cacheFileName = `${Date.now()}-${asset.fileName || 'unknown-image'}`;
          const targetUri = `${FileSystem.cacheDirectory}${cacheFileName}`;
          
          // 复制文件到应用缓存目录
          await FileSystem.copyAsync({
            from: asset.uri,
            to: targetUri,
          });

          // 返回替换为file URI的资源对象
          return { ...asset, uri: targetUri };
        }
        return asset;
      } catch (err) {
        // 标记该图片处理失败，不中断其他图片
        console.warn(`图片处理失败: ${err.message}`, asset.uri);
        return { ...asset, processingFailed: true };
      }
    })
  );

  // 过滤处理成功的图片，用于后续业务逻辑
  const validAssets = processedAssets.filter(item => !item.processingFailed);
  
  // 可选：给用户反馈处理结果
  if (validAssets.length < processedAssets.length) {
    alert(`成功加载${validAssets.length}张图片，${processedAssets.length - validAssets.length}张图片无法加载`);
  }

  // 这里使用validAssets进行上传/展示等操作
}

2. 针对多选场景的优化 #

• 不要全局捕获错误中断流程，而是对每张图片单独处理，标记失败项后过滤使用
• 在UI层面可以给失败的图片添加“加载失败”标识，或者直接隐藏，同时给出简洁的文字提示，避免用户困惑

注意事项 #

• 确保已安装expo-file-system：执行npx expo install expo-file-system完成安装
• 应用缓存目录的文件会在应用卸载时自动清除，无需手动清理；若需长期保存，可改用FileSystem.documentDirectory
• 部分特殊的content:// URI可能没有读取权限，此时仍会处理失败，这种情况属于系统限制，只能提示用户更换图片

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