必须调用c.ParseMultipartForm()才能使用c.FormFile()，否则返回nil和http.ErrMissingFile；Echo不自动解析multipart数据，需显式设内存阈值，建议32MB。
文件上传前必须调用 c.ParseMultipartForm()
不调用这一步，c.FormFile() 会返回 nil 和 http.ErrMissingFile 错误，不是框架 bug，而是 Go 标准库的硬性要求。Echo 不会自动解析 multipart 数据，必须显式指定内存阈值。
常见错误现象：FormFile("file") 返回 nil，日志里看不到任何报错，但请求体实际已含文件数据。
- 内存阈值建议设为
32 （32MB），太小会导致文件被写入临时磁盘，影响性能；太大可能耗尽内存 - 必须在
c.FormFile()之前调用，顺序不能颠倒 - 如果只处理小图/表单，设
4 （4MB）也够用
c.FormFile() 返回的是 *multipart.FileHeader，不是文件内容
它只包含文件名、大小、Header 等元信息，真正读取内容需要打开文件流。直接打印 fileHeader.Filename 没问题，但想读内容必须用 fileHeader.Open()。
使用场景：校验文件类型、限制大小、重命名、保存到磁盘或对象存储。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 检查大小：用
fileHeader.Size，单位是字节，别和Content-Length混淆 - 获取 MIME 类型：用
fileHeader.Header.Get("Content-Type")，但不可信，需用net/http.DetectContentType()读前几个字节验证 - 打开后记得
defer f.Close()，否则句柄泄漏
保存文件时优先用 io.Copy()，别用 ioutil.ReadAll()
大文件（>10MB）用 ioutil.ReadAll() 会把整个文件加载进内存，容易触发 OOM。Echo 示例里常省略这点，但生产环境必须避免。
性能影响明显：100MB 文件用 ReadAll 可能吃掉 150MB 内存；用 io.Copy 内存占用稳定在几 KB。
- 正确做法：
f, _ := fileHeader.Open(); defer f.Close(); out, _ := os.Create("/path/to/save"); defer out.Close(); io.Copy(out, f) - 路径要校验：过滤
../、空文件名、非法扩展名，否则有路径遍历风险 - 生成唯一文件名推荐用
uuid.New().String() + filepath.Ext(fileHeader.Filename)
客户端 HTML 表单必须带 enctype="multipart/form-data"
漏写这个属性，浏览器会以 application/x-www-form-urlencoded 发送，服务端收不到 multipart 数据，c.FormFile() 必然失败。
错误示例：<form method="POST"> —— 缺少 enctype，上传按钮点击后后端收不到文件。
- 完整写法：
<form method="POST" enctype="multipart/form-data"><input type="file" name="file"></form> - 字段
name="file"必须和c.FormFile("file")中的字符串完全一致，区分大小写 - 前端如用 axios，需传
FormData对象，且不能手动设Content-Type，让浏览器自动加 boundary
