React Native使用expo-video-thumbnails iOS端Can't write to file报错问题

• iOS沙盒权限约束：iOS对应用文件读写的管控远严格于Android，expo-video-thumbnails默认写入路径如果不在应用沙盒授权范围内，就会直接抛出写入失败错误，Android默认路径属于应用可访问的沙盒目录，因此不会触发报错
• 输出路径未显式指定：未传入cacheDir参数时，部分版本的库在iOS端会默认使用系统公共缓存路径，该路径应用无写入权限
• 文件名冲突或文件锁定：重复生成同一文件名的缩略图、前序生成的文件未被系统释放时，会触发写入冲突
• 视频URL不兼容：如果传入的视频URL包含特殊字符、或者为非授权路径的本地文件，会导致库解析路径时生成非法输出路径，触发写入失败

1. 显式指定应用沙盒内的输出目录
   先安装expo-file-system依赖，调用时指定cacheDir为应用可访问的缓存目录：

import * as VideoThumbnails from 'expo-video-thumbnails';
import * as FileSystem from 'expo-file-system';

const thumbnail = await VideoThumbnails.getThumbnailAsync(link, { 
  time: 2000,
  cacheDir: FileSystem.cacheDirectory
});

2. 配置唯一文件名避免冲突
   生成唯一文件名传入，避免重名写入冲突：

import * as VideoThumbnails from 'expo-video-thumbnails';
import * as FileSystem from 'expo-file-system';
import { randomUUID } from 'expo-crypto';

const uniqueFilename = `${randomUUID()}.jpg`;
const thumbnail = await VideoThumbnails.getThumbnailAsync(link, { 
  time: 2000,
  cacheDir: FileSystem.cacheDirectory,
  filename: uniqueFilename
});

3. 补全iOS权限配置
   在app.json中添加iOS相关权限声明：

{
  "expo": {
    "ios": {
      "infoPlist": {
        "NSPhotoLibraryAddUsageDescription": "需要存储权限保存媒体缩略图",
        "NSPhotoLibraryUsageDescription": "需要读取权限访问媒体文件"
      }
    }
  }
}

修改配置后卸载原有应用，重新编译安装确保权限生效。
4. 兼容视频URL格式

• 确保远程视频URL为http/https开头的公网可访问地址，本地视频路径需属于FileSystem.cacheDirectory或FileSystem.documentDirectory范围内
• 若URL包含中文、特殊字符，先做URL编码后再传入

5. 升级依赖版本
   如果以上配置均无效，升级expo-video-thumbnails到最新稳定版，部分旧版本存在iOS路径解析的已知bug。

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