使用mt-downloader通过HTML FileSystem API保存文件时路径报错如何解决？

你遇到的这个问题核心在于HTML FileSystem API的沙箱安全限制——它和mt-downloader的运行环境完全不是一回事！mt-downloader能直接写入/var/datafiles/filename.ext，是因为它运行在拥有系统文件操作权限的环境（比如服务器进程、本地桌面程序），但浏览器的文件API被严格限制在沙箱里，绝对不允许直接访问系统级的绝对路径（比如/var/这类根目录下的路径）。

下面是具体的解决思路和正确用法：

1. 先纠正认知：浏览器API不能直接写系统路径 #

浏览器的文件系统API只能操作两类合法路径：

• 浏览器自动分配的临时/持久化沙箱目录（比如Chrome对应下载存储区、IndexedDB关联的文件空间）
• 用户主动授权的本地目录/文件（通过File System Access API的选择器主动获取权限）

2. 用File System Access API实现合法保存 #

如果需要让用户选择保存位置并写入文件，可以用现代浏览器支持的showSaveFilePicker()或showDirectoryPicker()来获取合法的文件句柄，示例代码如下：

async function saveDownloadedFile(content, filename) {
  try {
    // 弹出选择框让用户确认保存的文件和位置
    const fileHandle = await window.showSaveFilePicker({
      suggestedName: filename,
      types: [{
        description: '目标文件类型',
        accept: {'application/octet-stream': ['.ext']} // 替换成你的文件类型
      }]
    });

    // 创建写入流并写入内容
    const writableStream = await fileHandle.createWritable();
    await writableStream.write(content); // content可以是Blob、ArrayBuffer等下载得到的内容
    await writableStream.close();

    console.log('文件保存成功！');
  } catch (err) {
    console.error('保存失败:', err);
  }
}

// 调用示例：假设你已经通过mt-downloader拿到了Blob格式的文件内容
const downloadedBlob = new Blob(['你的文件内容'], {type: 'application/octet-stream'});
saveDownloadedFile(downloadedBlob, 'filename.ext');

3. 如需持久化存储（无需用户每次选择） #

如果只是需要在浏览器内持久化保存文件，不需要用户看到本地文件，可以请求目录的持久化权限，把目录句柄存在IndexedDB里下次复用：

async function getPersistentStorageDir() {
  const dirHandle = await window.showDirectoryPicker();
  // 请求持久化读写权限，下次打开页面无需重新选择
  await dirHandle.requestPermission({mode: 'readwrite'});
  // 可以把dirHandle序列化后存入IndexedDB，后续直接取用
  return dirHandle;
}

核心区别再强调 #

• mt-downloader：运行在系统权限环境，可以自由操作任意系统文件路径
• HTML FileSystem API：运行在浏览器沙箱，只能操作用户授权的路径或浏览器分配的沙箱路径，禁止直接访问系统根目录等敏感路径

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