Angular 端批量上传文件夹至Azure Blob Storage的方案咨询

没有Azure Blob Storage原生支持的、单HTTP请求承载多文件内容、一次性写入指定容器文件夹的内置实现。

原生能力边界 #

Azure Blob的REST协议和官方JS SDK，所有写入操作的粒度都是单Blob对象：每个Blob的创建、写入、提交都是独立的事务级操作，没有兼容multipart多字段格式、在单请求内解析拆分多文件并写入不同Blob路径的原生接口能力。即使使用SDK提供的单文件上传方法，底层也是根据文件大小自动调用单PutBlob、分块上传、追加块等独立接口完成单文件写入，不存在跨文件的请求聚合能力。

可落地的适配方案 #

结合你原有的文件夹上传流程，可按业务诉求选择以下实现：

• 轻量一次鉴权+分文件直传（生产首选）
  完全保留用户选择本地文件夹的交互逻辑：前端收集文件夹下所有文件的相对路径、大小、元信息后，向后端发起一次无文件内容的轻量请求；后端在这单次请求内完成权限校验、生成每个文件对应Blob路径的写权限SAS令牌、映射好目标存储路径，一次性返回前端。
  后续每个文件的传输直接由前端通过JS SDK直连Blob存储完成，全程文件内容不经过App Service服务器。这个方案完全剥离了原流程中占主要开销的服务器转发、multipart解析、临时文件落盘环节，实际传输性能比原有全量走App Service的模式提升数倍，也是Azure官方推荐的批量文件夹上传实现路径。
• 自定义合并单请求上传（特殊场景适配）
  如果严格要求单HTTP请求完成所有文件的传输，只能在业务层做封装：前端将所有选中的文件按照自定义二进制格式拼接成单个大文件（包含每个文件的文件名、内容偏移量、长度等索引信息），将这个合并后的大文件作为单个Blob上传到目标容器的临时路径。后续通过Blob存储的事件触发机制，在服务端自动将合并文件按索引拆分，写入到对应的目标文件夹路径下，再清理临时合并文件。
  该方案复杂度较高：需要前端实现文件拼接、大文件断点续传兼容，服务端实现拆分逻辑、异常重试机制，仅适合小文件批量上传的场景，不适合混合大文件的文件夹上传需求。
• 避坑提示
  不要尝试将多个文件的内容塞入Blob的块结构实现多文件存储，Blob的块提交逻辑是单对象维度的事务操作，跨文件的块写入会出现内容错位、权限失控、存储结构损坏的问题，不具备生产可用性。

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