因为 Echo 不会自动解析 multipart 数据，必须显式调用 c.Request().ParseMultipartForm(32 << 20)，否则 FormFile 返回 nil；前端还需确保使用 multipart/form-data 编码提交。
echo.Context.FormFile 读取上传文件时为什么总是 nil
因为没调用 c.Request().ParseMultipartForm，或者前端没用 multipart/form-data 编码提交。Echo 不会自动解析 multipart 数据，必须显式触发解析，否则 c.FormFile() 返回 nil 且无错误提示。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 在 handler 开头加
c.Request().ParseMultipartForm(32 （32MB 限制，按需调整） - 确保 HTML 表单的
enctype="multipart/form-data"属性存在 - 检查请求方法是否为
POST或PUT，GET不支持文件上传 - 用 curl 测试时别漏掉
-F "file=@/path/to/file"，而不是-d
保存文件前必须检查 os.OpenFile 的权限和路径安全
直接拼接用户传来的 filename 写入磁盘，极易导致路径遍历（如 ../../etc/passwd）或覆盖关键文件。Echo 不做文件名清洗，这事得自己拦住。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
filepath.Base(f.Filename)提取纯文件名，丢弃所有路径部分 - 用
strings.ReplaceAll(filename, "..", "")不够安全，应改用filepath.Clean()+ 再次比对是否仍含.. - 保存目录必须预先创建且可写：
os.MkdirAll(uploadDir, 0755) - 避免用用户原始名存盘，推荐生成唯一名：
uuid.New().String() + filepath.Ext(filename)
使用 c.SaveUploadedFile 比手动 copy 更省心但有隐含限制
c.SaveUploadedFile 封装了打开、复制、关闭流程，适合简单场景；但它内部调用 file.Open 和 os.Create，不支持自定义缓冲区大小或进度回调，且无法处理大文件流式写入。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 小文件（c.SaveUploadedFile(file, dstPath)
- 大文件或需校验（如 SHA256）、限速、中断续传，应手动
file.Open()后用io.CopyN或带 buffer 的io.Copy -
SaveUploadedFile会把临时文件整个读进内存再写盘，OOM 风险比流式高 - 它不校验目标路径合法性，仍需自己 sanitize
dstPath
上传后清理临时文件：Echo 默认用 os.TempDir() 存 multipart 缓存
当文件超过 ParseMultipartForm 设置的内存阈值（默认 32MB），Go 会把超出部分暂存到磁盘临时目录，Echo 不自动清理这些临时文件——它们会一直留在 /tmp 或系统指定位置，直到被系统回收或磁盘满。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 调用
c.FormFile()后，若不需要再次读取，立刻用file.Open()打开并完成保存，然后让 GC 回收临时句柄 - 更稳妥的做法是：手动
os.Remove(file.Header.Filename)？不行——file.Header.Filename是原始名，不是临时路径；正确方式是访问file.Size判断是否已落盘，或直接信任 Go 的multipart.Reader自动清理逻辑（仅当请求结束且无引用时） - 实际更可控：设小一点的内存阈值（如
4 ），让多数文件走内存，减少磁盘临时文件生成 - 定期清理
os.TempDir()下以multipart-开头的残留文件（需额外守护进程或 cron）
