c.FormFile()不适用于批量下载,批量下载需用net/http与archive/zip手动构建ZIP响应流,注意路径校验、并发安全、显式调用zw.Close()及超时与数量限制。

c.FormFile() 不适用批量下载场景
别用 c.FormFile() 做批量下载——它只收单个上传文件,和下载完全无关。批量下载是服务端读多个已有文件、打 ZIP、吐响应流的过程,和表单提交、multipart/form-data 没半点关系。
用 net/http + archive/zip 手动构建 ZIP 响应流
Echo 本身不提供 ZIP 打包中间件,得自己用 Go 标准库拼装。关键不是“怎么路由”,而是“怎么在 handler 里安全生成 ZIP 并写回 c.Response()”。
- 设置响应头:
c.Response().Header().Set("Content-Type", "application/zip")和c.Response().Header().Set("Content-Disposition", `attachment; filename="files.zip"`) - 用
zip.NewWriter(c.Response().Writer)直接往 HTTP 响应流写入,避免内存缓存大 ZIP 文件 - 对每个待打包文件:
file, err := os.Open(path)→fw, err := zw.Create(filepath.Base(path))→io.Copy(fw, file)→ 记得file.Close() - 最后必须调
zw.Close(),否则 ZIP 文件损坏(浏览器解压报错:invalid zip header)
路径校验和并发安全不能省
用户传来的文件 ID 列表若直接拼进 os.Open(),极易触发路径遍历(如传 ../../../etc/passwd)。同时,高并发下多个 goroutine 共享同一个 zip.Writer 会 panic。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 用
filepath.Clean()+ 白名单目录前缀校验:确保filepath.Join(baseDir, userPath)仍落在baseDir下 - 每个文件单独打开、复制、关闭;不要复用
file句柄 -
zip.Writer是非线程安全的,所有zw.Create()和io.Copy()必须串行执行(别用 goroutine 包裹) - 若需提速,可先并发读取文件内容到内存
[]byte,再串行写入 ZIP —— 但要严控总大小,防 OOM
BodyLimit 和超时配置必须前置
批量下载接口看似只“读”不“写”,但 ZIP 流生成过程可能卡在大文件 IO 上。没设超时,客户端就一直转圈;没设 BodyLimit,恶意请求可能伪造超长文件 ID 列表触发大量磁盘读。
- 在路由注册前加:
e.Use(middleware.TimeoutWithConfig(middleware.TimeoutConfig{Timeout: 30 * time.Second})) -
BodyLimit对下载接口其实无效(不读 request body),但若你用 query 或 JSON 传文件 ID 列表,就得限制:e.Use(middleware.BodyLimit("2M")) - 更稳妥的是在 handler 开头校验 ID 数量:
if len(fileIDs) > 100 { return c.String(http.StatusBadRequest, "too many files") }
真正容易被忽略的,是 zip.Writer.Close() 的调用时机和错误处理——它会 flush 缓冲并写入 EOCD(End of Central Directory),漏掉这步,前端下载的 ZIP 就打不开。别只 defer,要显式判断 zw.Close() 的返回 err。


















