结论：Echo 中上传用 c.FormFile + file.Open() + io.Copy，下载大文件必须用 c.File()（非 e.Static()），因其支持流式传输、断点续传与范围请求；c.FormFile 失败主因是表单 name 不匹配、缺失 multipart/form-data 头、提前读取 r.Body 或文件为空。
直接说结论：Echo 框架里文件上传靠 c.FormFile + file.Open() + io.Copy，下载靠 c.File()（不是 e.Static()），大文件必须校验路径、设超时、禁用内存全载。
为什么 c.FormFile 拿不到文件？常见 4 种原因
不是前端没发，而是服务端解析失败或参数不匹配：
-
c.FormFile("file")中的"file"必须和 HTML 表单<input type="file" name="file">的name完全一致（区分大小写） - HTTP 请求头缺失
Content-Type: multipart/form-data; boundary=...—— 用curl -F或 FormData API 才会自动带上，别手动拼 raw body - 没调
r.ParseMultipartForm？其实 Echo 内部已自动调用，但若你提前读了r.Body（比如用了中间件 log body），会导致FormFile返回nil - 上传文件为空（
file.Size == 0）且没做判空，后续file.Open()会 panic；建议加if file.Size == 0 { return c.JSON(http.StatusBadRequest, "empty file") }
c.File() 下载 vs e.Static()：别用错场景
e.Static("/uploads", "uploads") 是为静态资源（CSS/JS/图片）设计的，它不支持大文件流式传输，50MB 视频大概率触发 ERR_CONNECTION_RESET。真正该用的是 c.File(filepath)：
-
c.File()底层调用http.ServeContent，自动设置Accept-Ranges: bytes、Content-Length和Last-Modified，浏览器拖进度条、断点续传都正常 - 必须校验
filename参数防路径遍历：比如c.Param("filename")是"../etc/passwd"，直接path.Join("uploads", filename)就危险了，得先strings.Contains(filename, "..") || strings.HasPrefix(filename, "/") - 不自动处理 MIME 类型？其实是处理的：
.mp4 → video/mp4、.pdf → application/pdf，但扩展名必须正确；若文件无后缀，可手动w.Header().Set("Content-Type", "application/octet-stream")
上传大文件（>10MB）必须调的三个配置
默认情况下，Echo 会把整个 multipart body 加载进内存，超限就 400；即使没超，TCP 超时也会中断上传。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 全局限制内存使用：在
e := echo.New()后加e.Use(middleware.BodyLimit("50MB"))（注意单位是字符串，不是数字） - 提升 HTTP Server 超时：启动前设置
e.Server.ReadTimeout = 300 * time.Second、e.Server.WriteTimeout = 300 * time.Second（尤其下载大视频时 WriteTimeout 更关键） - 避免临时文件爆磁盘：Echo 默认把 multipart 文件暂存到
/tmp，如果并发高、文件大，/tmp可能写满；可通过os.Setenv("TMPDIR", "/data/tmp")指向更大分区
多文件上传和分片上传的取舍
普通业务用 c.MultipartForm() 拿 form.File["files"] 列表即可，但要注意：
- 前端
<input type="file" name="files" multiple>，后端form.File["files"]是 slice，循环处理每个*multipart.FileHeader - 分片上传（如 tus 协议）适合 >100MB 场景，但要自己管理 chunk 合并、MD5 校验、断点续传状态存储；除非真有网不好用户或合规要求，否则别过早引入复杂度
- 安全红线：所有上传文件必须重命名（别信
file.Filename），用 UUID + 原扩展名；同时校验file.Header.Get("Content-Type")防伪装（比如把 .exe 改成 .jpg）
最易被忽略的一点：下载路由若用 e.GET("/download/:filename", ...)，而用户传入带 URL 编码的 %2F（即 /），c.Param("filename") 不会自动解码，导致路径校验失效；务必先 url.PathUnescape(c.Param("filename")) 再判断是否含 ..。
