因为c.FormFile底层调用http.Request.ParseMultipartForm，会将整个multipart body一次性读入内存（默认上限32MB），超限即报“http: request body too large”错误，属Go标准库默认行为，需提前调用ParseMultipartForm并设MaxMemory。
为什么 c.FormFile 不能直接处理大文件上传
因为 c.FormFile 底层调用的是 http.Request.ParseMultipartForm，它会把整个 multipart body 一次性读入内存（默认上限 32MB），超限直接报错 http: request body too large。这不是 Echo 的限制，而是 Go 标准库的默认行为。
- 必须在路由 handler 执行前，通过
c.Request().ParseMultipartForm主动设置MaxMemory（如32 ）并指定临时目录（<code>os.TempDir()或自定义路径） - 若不设临时目录，超内存部分会写入系统默认临时区，但 Windows 下可能因权限问题失败，Linux 下也可能被 SELinux 拦截
- 不要依赖
echo.MiddlewareFunc统一解析——ParseMultipartForm只能调用一次，重复调用会返回http.ErrNotMultipart
如何安全地流式保存上传文件避免内存爆炸
拿到 *multipart.FileHeader 后，必须用 fileHeader.Open() 获取只读流，再用 io.Copy 直接写入目标文件句柄，全程不加载全文到内存。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 务必检查
fileHeader.Size是否超过业务允许上限（如 500MB），并在Open()前校验，否则恶意用户可构造超大Size值绕过前端限制 - 使用
os.OpenFile(path, os.O_CREATE|os.O_WRONLY|os.O_TRUNC, 0644)创建目标文件，避免os.Create在 NFS 等文件系统上出现权限异常 - 记得
defer dst.Close()和src.Close()，漏关会导致文件句柄泄漏，Linux 默认单进程最多 1024 个
src, err := fileHeader.Open()
if err != nil {
return err
}
defer src.Close()
dst, err := os.OpenFile("/upload/"+fileHeader.Filename, os.O_CREATE|os.O_WRONLY|os.O_TRUNC, 0644)
if err != nil {
return err
}
defer dst.Close()
_, err = io.Copy(dst, src)
如何支持多文件 + 进度反馈 + 断点续传
Echo 本身不提供上传进度或断点能力，需组合外部方案：前端用 XMLHttpRequest.upload.onprogress 或 fetch 分块上传，后端用唯一 upload_id 标识分片，落地为临时分片文件，合并时校验 SHA256。
- 不要用 session 存进度——分布式部署下 session 不共享；改用 Redis 存
upload_id → {total, uploaded, status}结构 - 分片命名建议为
{upload_id}_{index}_{total}.part，合并前按index排序并逐个校验大小和哈希 - 合并操作必须加文件锁（
flock或 Redis 分布式锁），否则并发请求可能造成文件损坏 - 临时分片目录需定期清理（如用
find /tmp/uploads -name "*.part" -mmin +60 -delete），否则磁盘会被占满
常见错误：上传后文件内容为空或损坏
最常发生在忘记关闭源流或目标文件，或者错误地用 io.ReadAll(src) 全量读取再写入——这会让大文件瞬间吃光内存并触发 OOM kill。
- 错误示范：
data, _ := io.ReadAll(src); _ = os.WriteFile(..., data, 0644)—— 仅适用于 KB 级小文件 - 正确做法永远是
io.Copy或带 buffer 的io.CopyBuffer(dst, src, make([]byte, 32*1024)) - 如果用了
gzip.NewReader或其他包装 reader，确保原始fileHeader.Open()返回的io.ReadCloser仍被正确关闭 - Windows 下注意路径分隔符，
filepath.Join("upload", fileHeader.Filename)比字符串拼接更安全
