如何在Echo框架中实现上传文件自动保存-Golang-PHP中文网

echo框架不自动保存上传文件，需手动调用file.save或file.open后写入磁盘；c.formfile仅返回*multipart.fileheader元数据，不含文件内容，真正读取需open或save，否则数据被gc丢弃。

如何在echo框架中实现上传文件自动保存

直接说结论：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

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")
}