webkitdirectory 仅支持单文件夹选择,无法批量选多个文件夹;需用拖放API+递归遍历实现多文件夹上传,并后端校验净化 relativePath 防路径穿越。

直接用 无法实现“快速批量上传多个文件夹”,这是浏览器原生限制——它只支持一次选一个文件夹。所谓“快速批量”,必须绕过这个限制,用拖放 API + 递归遍历替代。
为什么 webkitdirectory 不能多选文件夹
Chrome/Edge 支持 webkitdirectory,Firefox 支持 directory,但两者都只响应单次文件夹选择事件。即使加了 multiple,浏览器也只会把该文件夹下所有子文件扁平化为一个 FileList,不会识别“这是第几个文件夹”。你看到的多个文件,其实全来自同一个根路径。
- 错误现象:
e.target.files.length很大,但所有文件的webkitRelativePath都以相同前缀开头(如"project/src/main.js"、"project/README.md"),说明它们同属一个被选中的文件夹 - 根本原因:操作系统级文件对话框不提供“多文件夹复选”能力,HTML 规范也没定义该行为
- 兼容性陷阱:Safari 完全不支持
webkitdirectory;移动端基本不可用
用拖放 API 实现真正多文件夹选择
用户把多个文件夹拖进页面区域,通过 event.dataTransfer.items 获取 FileSystemEntry 对象,再递归读取每个入口下的全部文件,同时保留各自原始路径上下文。
- 关键判断:遍历
items时用item.webkitGetAsEntry()(Chrome/Edge)或item.getAsEntry()(Firefox),再检查entry.isDirectory - 必须递归:单个文件夹可能嵌套多层,需用
createReader().readEntries()深度遍历,不能只读一层 - 路径隔离:每个文件对象要打上来源文件夹标识,比如
{ file, folderRoot: "design_v2/" },否则后端无法重建结构 - 示例片段:
dropzone.addEventListener('drop', async (e) => {
e.preventDefault();
const entries = [];
for (const item of e.dataTransfer.items) {
const entry = item.webkitGetAsEntry?.() || item.getAsEntry?.();
if (entry && entry.isDirectory) entries.push(entry);
}
const allFiles = await Promise.all(entries.map(readDirectoryRecursively));
});
上传阶段的效率瓶颈与绕过方式
前端拼接大量 FormData 或一次性发巨量请求,极易触发内存溢出或连接超时。真实高效不是“传得快”,而是“不卡、不断、可控”。
- 别用单个
FormData.append("files[]", file)塞几千个文件——浏览器会把所有文件内容加载进内存 - 改用分片并发:每 5–10 个文件组成一个请求体,用
Promise.allSettled控制并发数(建议 ≤ 4) - 服务端必须支持路径字段:每个文件需携带
relativePath(如"folderA/sub/img.png"),否则无法还原目录树 - 大文件(>10MB)要额外走分片上传逻辑,和文件夹逻辑正交,不能混在同一个流程里处理
后端重建目录结构的关键校验点
前端传来的 webkitRelativePath 是不可信的——攻击者可伪造路径穿越(如 "../../etc/passwd")。后端必须做白名单清洗,而非简单拼接。
- 必须截断路径开头的
"./"和多余"/",统一用path.posix.normalize()(Node)或os.path.normpath()(Python)标准化 - 强制校验路径是否以预设安全前缀开头(如
"upload_20261105/"),拒绝任何含".."或绝对路径的输入 - 禁止创建隐藏文件夹(如
".git"、"__MACOSX"),机械制造类系统尤其要过滤"Thumbs.db"、"desktop.ini" - 最终写入路径应为:
SAFE_BASE_DIR + hash_of_user_id + "/" + sanitized_relative_path,避免用户间路径冲突
真正卡住项目进度的,往往不是“怎么选文件夹”,而是后端没对 webkitRelativePath 做路径净化,或者前端把几千个文件塞进一个请求导致页面假死。这两个点不提前压住,所谓“快速批量”只是幻觉。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











