讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

立刻MV
立刻MV

低成本歌曲 MV、视频生成

SoundView
SoundView

字幕擦除翻译、配音口型同步

AniShort
AniShort

AI短剧协同制作平台

Echo框架路由怎么实现文件批量打包下载

星晨大大_8673

星晨大大_8673

发布时间:2026-11-22 08:35:47

|

913人浏览过

|

来源于php中文网

原创

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

echo框架路由怎么实现文件批量打包下载

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。

Skill Weave Chains — 技能链路由引擎
Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。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。

相关文章

路由优化大师
路由优化大师

路由优化大师是一款及简单的路由器设置管理软件,其主要功能是一键设置优化路由、屏广告、防蹭网、路由器全面检测及高级设置等,有需要的小伙伴快来保存下载体验吧!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

相关专题

更多
Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

0

2026.11.20

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

0

2026.11.20

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

0

2026.11.20

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

0

2026.11.20

PHP8.6升级迁移教程
PHP8.6升级迁移教程

本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。

0

2026.11.20

PHP8.6安装配置与FPM运维教程
PHP8.6安装配置与FPM运维教程

本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。

0

2026.11.20

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

20

2026.11.20

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

80

2026.11.17

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

80

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Echo框架路由配置手册
Echo框架路由配置手册

共0课时 | 0人学习

Revel 官方开发手册
Revel 官方开发手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn