Echo框架不自动保存上传文件，需手动调用file.Save或file.Open后写入磁盘；c.FormFile仅返回*multipart.FileHeader元数据，不含文件内容，真正读取需Open或Save，否则数据被GC丢弃。
直接说结论：Echo 框架本身不处理文件落地，必须手动调用 file.Save 或读取 file.Open 后写入磁盘；漏掉这步，文件就只在内存里“路过”一遍，根本不会保存。
为什么 c.FormFile 拿到的只是元数据
很多人以为 c.FormFile("avatar") 返回的是已读取的文件内容，其实它只返回一个 *multipart.FileHeader —— 里面只有文件名、大小、MIME 类型和临时路径（如果启用了 MaxMemory），没有实际字节流。真正触发读取和保存，得靠后续操作。
-
file.Open()才打开底层io.ReadCloser，此时才开始从 multipart body 中解析出原始数据 -
file.Save("/path/to/save.jpg")是封装好的快捷方式，内部做了Open+os.Create+io.Copy - 若跳过这两步，
file对象一出作用域就被 GC，上传数据彻底丢弃
保存前必须检查 MaxMemory 和临时目录
Echo 默认使用 Go 标准库的 multipart.Reader，其行为受 http.MaxBytesReader 和 form.ParseMultipartForm 影响。Echo 的 echo.Echo 实例默认设置了 MaxMemory: 32 （32MB），超过该值的文件会被自动写入临时磁盘（由 <code>os.TempDir() 决定）。这意味着：
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 小文件（≤32MB）全程在内存，
file.Open()直接返回内存 reader - 大文件会先落盘到系统临时目录，
file.Open()返回的是对那个临时文件的只读句柄 - 如果你没显式清理或没权限写入
os.TempDir()，大文件上传会失败并报错open /tmp/xxx: permission denied - 可通过
e.MaxMemory = 64 调高阈值，或提前设置 <code>os.Setenv("TMPDIR", "/your/writable/dir")
推荐写法：用 file.Save + 显式路径校验
最简且安全的做法是用 file.Save，但必须自己拼目标路径，并确保父目录存在。别依赖相对路径或硬编码根路径。
file, err := c.FormFile("upload")
if err != nil {
return c.String(http.StatusBadRequest, "no file received")
}
dst := filepath.Join("./uploads", file.Filename)
if err := os.MkdirAll(filepath.Dir(dst), 0755); err != nil {
return c.String(http.StatusInternalServerError, "failed to create upload dir")
}
if err := file.Save(dst); err != nil {
return c.String(http.StatusInternalServerError, "save failed: "+err.Error())
}
-
file.Filename来自客户端，不可信，生产环境务必重命名（如用 UUID + 扩展名） -
file.Size可在此处做大小限制，比如if file.Size > 10 -
file.Header.Get("Content-Type")可用于 MIME 白名单校验，防伪造
进阶：流式处理大文件避免 OOM
如果上传的是超大视频或日志包（>100MB），file.Save 会一次性加载到内存再写出，有 OOM 风险。此时应改用 file.Open + io.Copy 流式转发：
src, err := file.Open()
if err != nil {
return c.String(http.StatusInternalServerError, "open failed")
}
defer src.Close()
dst, err := os.Create(dstPath)
if err != nil {
return c.String(http.StatusInternalServerError, "create failed")
}
defer dst.Close()
if _, err := io.Copy(dst, src); err != nil {
return c.String(http.StatusInternalServerError, "copy failed")
}
- 这个模式下内存占用恒定（约 32KB buffer），适合处理 GB 级文件
- 注意
defer位置：必须在return前确保src和dst关闭，否则文件句柄泄漏 - 若需进度回调或断点续传，就得自己包装
io.Reader做计数器，Echo 不提供内置支持
真正容易被忽略的不是语法，而是临时文件生命周期和路径权限——file.Save 成功不代表磁盘真写入完成，os.Rename 或 sync.File.Sync 才算落盘可靠；而所有路径拼接都必须用 filepath.Join，Windows 下反斜杠会直接让保存失败。
