HTML原生不支持上传整个文件夹,需用File System Access API(如showDirectoryPicker)递归遍历并保留相对路径,后端须解析路径、创建嵌套目录且防范路径穿越攻击。

HTML 本身不能直接上传文件夹
浏览器原生的 <input type="file"> 不支持“同时选多个文件夹”——哪怕加了 multiple,也只允许多个文件或单个文件夹(通过 webkitdirectory)。所谓“上传整个文件夹”,本质是前端遍历其内容、逐个读取并打包上传,后端再按路径结构还原。你看到的“拖拽上传文件夹”功能,背后全是 JavaScript 驱动的 FileSystemDirectoryHandle(现代浏览器)或 webkitGetAsEntry()(旧版 Chrome),不是 HTML 自带能力。
webkitdirectory 只能选一个文件夹,且兼容性差
这个属性让 <input type="file" webkitdirectory> 弹出目录选择器,但它有硬伤:
- 仅 Chromium 系列(Chrome/Edge)和 Safari(有限支持)可用,Firefox 完全不认
- 返回的
FileList里只有根目录下的**直接子文件**,不递归包含子目录里的文件 - 无法获取文件在原始路径中的相对位置(比如
assets/img/logo.png会变成单纯logo.png) - 服务端拿到的只是扁平化的一堆文件,没法自动重建目录结构
真要上传多级文件夹,得用 File System Access API
这是目前唯一能可靠读取嵌套目录、保留路径信息的方案,但要求 HTTPS + 手动授权:
- 用户必须点击按钮触发
showDirectoryPicker(),不能自动调用 - 返回
FileSystemDirectoryHandle,可递归调用entries()遍历所有层级 - 每个
FileSystemFileHandle调用getFile()得到标准File对象,其webkitRelativePath属性(非标准但广泛存在)或手动拼接路径可保留原始层级 - 上传时需把路径作为额外字段传给后端,例如:
formData.append('path', 'docs/css/main.css')
示例关键片段:
立即学习“前端免费学习笔记(深入)”;
const dir = await window.showDirectoryPicker();
const formData = new FormData();
for await (const entry of dir.entries()) {
if (entry[1].kind === 'file') {
const file = await entry[1].getFile();
const path = entry[0]; // 如 'images/background.jpg'
formData.append('files', file, path); // 第三个参数设为 relative path
}
}
fetch('/upload', { method: 'POST', body: formData });
后端必须按路径结构保存,不能只 dump 到 flat 目录
如果前端传了 path 字段或用 File.name 携带层级(如 "src/js/app.js"),后端不做解析就直接 fs.writeFileSync('uploads/' + file.name),会导致路径分隔符被当普通字符处理,生成错误文件名(如 src%2Fjs%2Fapp.js)。正确做法是:
- Node.js:用
path.join(uploadRoot, decodedPath)拼接,并确保父目录存在(fs.mkdirSync(..., { recursive: true })) - PHP:用
dirname()提取路径、mkdir(..., 0755, true)创建嵌套目录 - 务必校验
decodedPath不含../等路径穿越字符串,否则有写入任意目录风险
最容易被忽略的是:前端传的路径是否经过 URL 解码,以及后端是否对路径做了安全过滤。没做这两步,看似上传成功,实际可能覆盖系统文件或写到意外位置。



















