Android 13中Ionic v7+Capacitor v5保存文件到外部存储失败怎么办？

代码参数校验 #

先确认你的writeFile调用参数完全合规，以下是标准可行的示例：

import { Filesystem, Directory, Encoding } from '@capacitor/filesystem';

async saveTestFile() {
  try {
    const writeResult = await Filesystem.writeFile({
      path: 'demo.txt', // 仅填文件名，不要带路径分隔符
      data: '测试文本内容',
      directory: Directory.Data,
      encoding: Encoding.UTF8
    });
    console.log('文件写入成功:', writeResult);
  } catch (err) {
    // 打印完整错误信息，这是定位问题的核心
    console.error('写入失败详情:', JSON.stringify(err));
  }
}

• path只需要文件名，Directory.Data已经指向应用私有目录，无需额外路径
• 必须指定encoding: Encoding.UTF8，否则文本会被当作二进制数据处理引发异常

Android配置与权限检查 #

1. 无需外部存储权限：Directory.Data对应应用私有内部存储目录（/data/data/[你的包名]/files），Android 13下访问该目录不需要申请WRITE_EXTERNAL_STORAGE或READ_MEDIA_IMAGES等外部存储权限，不要在AndroidManifest.xml中添加多余权限，避免冲突。
2. 清理无效配置：如果之前为外部存储添加过android:requestLegacyExternalStorage="true"，确认该配置仅针对外部存储场景，不要影响内部存储操作。

调试与验证步骤 #

1. 定位错误原因：在catch块中打印完整错误对象，包括错误码、具体信息，常见问题有文件名非法、存储空间不足、参数错误等。
2. 验证目录内容：调用readdir接口查看Directory.Data下的文件列表，确认目标文件是否存在：

async checkDataDirFiles() {
  const files = await Filesystem.readdir({ directory: Directory.Data });
  console.log('Data目录文件列表:', files.files);
}

3. 手动检查文件系统：通过Android Studio的Device File Explorer，进入/data/data/[你的应用包名]/files目录，直接查看文件是否写入成功。

特殊场景处理 #

• 写入大文件前，先检查设备内部存储剩余空间是否充足
• 确保写入操作在异步函数中执行，不要在Angular主线程同步调用阻塞操作

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