静态资源上传在 Echo 中需分「接收上传」和「提供访问」两阶段；c.FormFile 仅返回 *multipart.FileHeader，须调用 Open() 获取流并用 io.Copy 写入目标路径，同时校验 Size 防超大文件。
静态资源上传在 Echo 中不是“上传后自动托管”，而是需要你明确区分「接收上传」和「提供访问」两个阶段；直接调用 c.FormFile 只负责读取，不负责存储或公开 URL。
如何用 c.FormFile 安全接收上传文件
这是最常被误用的一步：很多人以为调用 c.FormFile 就等于“上传完成”，其实它只返回一个 *multipart.FileHeader，内容还在内存或临时磁盘上，没落地。
- 必须手动调用
fileHeader.Open()获取可读流，再用io.Copy写入目标路径（如/uploads/） - 务必检查
fileHeader.Size，防止恶意超大文件耗尽内存（Echo 默认限制 4MB，可通过e.MaxMultipartMemory = 32 调整） - 文件名不能直接信任：
fileHeader.Filename可能含路径遍历字符（如../../etc/passwd），需用path.Base()截取纯文件名 - 别忘了设置写权限：目标目录（如
./uploads）需提前os.MkdirAll创建，并确保进程有写权限
上传后怎么让前端能访问到文件
接收完文件只是第一步；Echo 不会自动把 /uploads/ 目录映射为 HTTP 路径。你需要显式挂载静态服务，且必须避开安全陷阱。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 错误做法：
e.Static("/static", "./uploads")—— 如果没禁用目录遍历，攻击者访问/static/..%2f..%2f/etc/passwd可能读取系统文件 - 正确做法：用
e.File("/static/:filename", "./uploads/:filename")，它只响应精确匹配，不支持路径遍历 - 更稳妥：用
http.FileServer+http.StripPrefix并自定义FileSystem实现白名单校验（比如只允许.jpg、.png后缀） - 注意 MIME 类型：Echo 的
File会自动推断，但若文件无扩展名，可能返回text/plain，导致浏览器下载而非渲染
c.FormFile 和 c.MultipartForm 选哪个
单文件上传用 c.FormFile 更简洁；多文件或需同时读表单字段时，c.MultipartForm 更可控，但容易踩内存坑。
-
c.FormFile("avatar")：适合头像、封面等单文件场景，返回单个*multipart.FileHeader -
form, _ := c.MultipartForm()：返回整个表单，form.File["files"]是切片，但所有文件会先全部解包到内存或临时磁盘——如果用户一次传 100 个 5MB 文件，MaxMultipartMemory不够就会报错 - 混合字段处理：若表单含
title文本字段和images[]文件字段，c.FormValue("title")和c.FormFile("images[]")可混用，无需上MultipartForm
为什么上传后的图片 URL 总是 404
绝大多数 404 不是代码写错，而是路径映射和文件落地不一致导致的。
- 检查文件是否真写进去了：上传 handler 里加
log.Printf("saved to: %s", dstPath)，然后手动ls ./uploads/确认 - 确认 URL 路径和静态路由前缀完全一致：比如你用
e.File("/media/:file", "./uploads/:file")，那前端必须请求/media/photo.jpg，而不是/uploads/photo.jpg或/static/photo.jpg - Linux 权限问题：Go 进程用户（如
www-data）可能无权读./uploads目录，用ls -l ./uploads检查属主和读权限 - 开发时用
go run，部署时用 systemd 或 piku，工作目录可能不同——硬编码"./uploads"会失效，应改用绝对路径或环境变量（如os.Getenv("UPLOAD_DIR")）
真正麻烦的从来不是接收文件那一行代码，而是文件落地位置、HTTP 可访问路径、权限、清理策略这四者的对齐；少对齐一环，前端就只能看到 404 或空白图。
