如何使用HTML和JavaScript通过文件选择器上传文件夹到Amazon S3服务器
HTML/JS实现文件夹直传Amazon S3的落地方案
1. 改造文件选择器,支持原生选取文件夹
把原来单文件选择的input调整为支持读取本地文件夹结构,新增文件夹选择相关属性:
<input type="file" id="folderPicker" webkitdirectory multiple>
浏览器触发文件夹选择后,返回的每个文件对象都会自带webkitRelativePath属性,属性值会完整保留文件在所选文件夹内的相对路径。比如选了名为我的素材库的文件夹,里面有logo.png、图片/banner.jpg,对应的相对路径就是我的素材库/logo.png、我的素材库/图片/banner.jpg,可以直接作为S3对象的Key,完整还原本地文件夹的层级结构。
2. 调整预签名POST的配置规则
原有单文件表单里的两个硬编码配置不适合多文件场景,需要调整:
- 删掉表单里固定写死的
key值的隐藏域,多文件场景下每个文件的Key是动态生成的 - 调整预签名policy里的Key匹配规则:把原来
starts-with $key ""的规则改为starts-with $key "自定义上传前缀/",同时根据新的policy内容,重新用S3 Secret Key生成对应的签名值(旧签名和新policy不匹配,会被S3拦截返回403) - 其余公共参数(AWSAccessKeyId、acl、success_action_status)可以保持不变,所有上传文件共用这套配置。
3. 编写逐文件循环上传的逻辑
S3的POST接口单次请求仅支持上传一个文件,所以需要遍历文件夹下的所有文件,逐个构造表单提交:
// S3上传基础配置 const S3_UPLOAD_ENDPOINT = "https://spreedemostore.s3.amazonaws.com/"; const UPLOAD_CONFIG = { AWSAccessKeyId: "AKIAIDSTEOFIIVTWCUFA", acl: "public-read", success_action_status: "201", // 替换为调整后policy生成的base64字符串 policy: "替换为新生成的policy值", // 替换为新policy对应的签名值 signature: "替换为新生成的签名值", // S3桶内的统一上传前缀,和policy里的匹配规则保持一致 keyPrefix: "user-uploads/" } // 监听文件夹选择动作 document.getElementById('folderPicker').addEventListener('change', async (e) => { const allFiles = Array.from(e.target.files); // 跳过系统自动生成的隐藏文件(比如.DS_Store),可选优化 const validFiles = allFiles.filter(file => !file.name.startsWith('.')); for (const file of validFiles) { // 动态构造当前文件的S3 Key const s3ObjectKey = `${UPLOAD_CONFIG.keyPrefix}${file.webkitRelativePath}`; // 构造当前文件的表单数据 const formData = new FormData(); formData.append('key', s3ObjectKey); formData.append('AWSAccessKeyId', UPLOAD_CONFIG.AWSAccessKeyId); formData.append('acl', UPLOAD_CONFIG.acl); formData.append('success_action_status', UPLOAD_CONFIG.success_action_status); formData.append('policy', UPLOAD_CONFIG.policy); formData.append('signature', UPLOAD_CONFIG.signature); formData.append('file', file); // 发起上传请求 const uploadResult = await fetch(S3_UPLOAD_ENDPOINT, { method: 'POST', body: formData }); console.log(`文件${s3ObjectKey}上传完成,状态码:`, uploadResult.status); } alert("所选文件夹内的所有合法文件已全部上传完成"); });
实际开发注意事项
- 原有示例中的policy过期时间是2014年的,已经完全失效,实际部署时要把policy的过期时间设置为15-30分钟,匹配用户选择文件夹、逐文件上传的总耗时
- 所有文件上传完成后,S3桶内的对象结构和本地所选的文件夹层级完全一致,不需要额外做文件夹映射
- 原生文件夹选择能力在Chrome、Edge、Safari、Firefox(113+版本)均已支持,不需要额外做跨浏览器兼容
- 如果需要控制上传并发,可以把for循环的串行上传改成有限并发的Promise调度,避免同时发起太多请求触发浏览器的接口并发上限
内容的提问来源于stack exchange,提问作者simpy kumari
相关产品推荐
相关产品推荐

