使用Ionic-Angular-Capacitor保存照片报无法创建根目录错误如何解决

1 修正核心代码错误 #

你当前的Filesystem.writeFile配置存在两个致命问题：

• 缺少directory参数：Capacitor不允许直接操作系统根目录，必须指定官方提供的沙盒目录常量，可选值包括Directory.Data（App私有数据目录，默认推荐）、Directory.Documents、Directory.Cache等
• path参数配置错误：你写死了/fullpath作为路径，既没有包含你生成的文件名，开头的斜杠也会被识别为系统根路径，应该用相对路径拼接文件名

修正后的代码示例：

// 首先从@capacitor/filesystem引入Directory常量
import { Filesystem, Directory } from '@capacitor/filesystem';

private async savePicture(cameraPhoto) {
  const base64Data = await this.readAsBase64(cameraPhoto);
  const fileName = new Date().getTime() + '.jpeg';
  try {
    const savedFile = await Filesystem.writeFile({
      path: `photos/${fileName}`, // 相对路径+文件名，recursive会自动创建photos目录
      data: base64Data,
      directory: Directory.Data, // 必须指定有权限的沙盒目录
      recursive: true,
    });
    return {
      format: 'jpeg', // 和生成的文件后缀保持一致
      filepath: `${savedFile.uri}/${fileName}`, // 可返回实际保存的完整路径
      webviewPath: cameraPhoto.webPath
    };
  } catch (e) {
    // 建议添加catch打印详细错误，方便后续排查
    console.error('保存文件失败', e);
    throw e;
  }
}

2 权限配置检查 #

• 如果你需要将照片保存到系统公共相册而非App私有目录：
  • Android端：在android/app/src/main/AndroidManifest.xml中添加存储权限声明（Capacitor 4+针对公共目录需要READ_MEDIA_IMAGES等权限）
  • iOS端：在Info.plist中添加NSPhotoLibraryAddUsageDescription权限描述，说明保存照片的用途
• 如果仅保存在App私有沙盒目录，不需要额外申请系统权限

3 数据格式验证 #

确认readAsBase64方法返回的内容格式正确：

• 如果返回的是纯base64字符串（不带data:image/jpeg;base64,前缀）可以直接传入
• 如果返回的是完整DataUrl，也可以直接传入，Capacitor 3+版本已自动支持DataUrl格式的写入

你也可以直接修改Camera的resultType为CameraResultType.DataUrl，省略手动转base64的步骤，直接把capturedPhoto.dataUrl作为writeFile的data参数，减少转换出错的概率。

4 运行环境验证 #

Capacitor Filesystem的Web端实现是基于IndexedDB模拟的，存在较多路径限制，建议直接打包为原生App在真机上测试，或者使用Capacitor的热重载功能在真机调试，避免Web端模拟环境的差异导致的误报。

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