React Native Expo环境下如何将asset-library://转为file://

架构老林

2026-9-29

核心问题排查

你当前代码的首要错误是FileSystem.copyAsync是异步方法，未添加await关键字，文件还没完成复制就直接执行读取操作，必然触发文件不存在的报错。
iOS 端asset-library://是系统相册资源的专属协议路径，没有映射到App沙盒内的可访问文件，因此无法直接用于图片展示或上传，必须转存为沙盒内的file://路径才可正常使用。

正确实现代码

import * as FileSystem from 'expo-file-system';

// 传入asset-library://路径，返回可直接使用的file://路径
const convertAssetUriToFileUri = async (assetUri) => {
  // 生成随机缓存文件名，自动适配后缀
  const fileExtension = assetUri.endsWith('.png') ? 'png' : 'jpg';
  const tempFilePath = `${FileSystem.cacheDirectory}${Math.random().toString(36).substring(7)}.${fileExtension}`;
  
  // 等待文件复制完成
  await FileSystem.copyAsync({
    from: assetUri,
    to: tempFilePath
  });

  // 直接返回沙盒路径即可，不需要额外读取文件内容
  return tempFilePath;
}

// 调用示例
try {
  const fileUri = await convertAssetUriToFileUri('asset-library://....');
  // 展示图片直接赋值给Image组件的source={uri: fileUri}即可
  // 上传文件直接传fileUri作为文件路径即可
  console.log('转换完成的路径:', fileUri);
} catch(e) {
  console.log('转换失败:', e);
}

注意事项

不要用readAsStringAsync读取图片文件：图片是二进制资源，用UTF8编码读取会直接损坏文件内容，无论展示还是上传都只需要用到转换后的file://路径即可，不需要读取文件内容。
需确认已配置iOS相册权限：在app.json中添加NSPhotoLibraryUsageDescription权限声明，没有相册访问权限会导致复制操作失败。
临时缓存的文件如果不需要长期保留，可定期清理避免占用用户存储空间。

搜索参考关键词