用 c.formfile() 获取上传文件需前端 enctype="multipart/form-data" 且 name 匹配；获取后通过 header.open() 和 io.copy() 安全保存，须校验路径、扩展名并确保目录存在。
如何用 c.FormFile() 获取上传的文件
Echo 框架里没有封装独立的“文件上传中间件”，直接用 c.FormFile() 就行，它底层调用的是 http.Request.FormFile()。关键前提是前端必须用 multipart/form-data 编码提交，且 input 的 name 属性值要和 FormFile() 的参数一致。
常见错误：前端用 application/json 发送 base64 字符串，后端却调 c.FormFile() —— 这时会返回 ErrMissingFile 错误。
- 确保 HTML 表单包含
enctype="multipart/form-data" -
FormFile("avatar")中的"avatar"必须和<input type="file" name="avatar">的name完全一致（区分大小写） - 如果表单有多个文件字段，每个都要单独调一次
FormFile()，不能传逗号分隔的字符串 - 若不确定字段名，可先用
c.MultipartForm()查看所有 key：form, _ := c.MultipartForm(); fmt.Println(form.File)
上传后怎么保存到磁盘（避免 os.Create() 权限/路径错误）
拿到 *multipart.FileHeader 后，要用 header.Open() 打开读取流，再用 io.Copy() 写入目标文件。别直接用 os.Create() 创建空文件再 Write() —— 那样会丢掉原始二进制结构，尤其对图片、PDF 等非文本文件必出错。
典型坑：os.Create("./uploads/" + header.Filename) 在容器或无写入权限目录下失败；或者没检查 uploads/ 目录是否存在，导致 open ./uploads/xxx: no such file or directory。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 先用
os.MkdirAll("./uploads", 0755)确保目录存在 - 对
header.Filename做基础校验：过滤../、空字符、控制字符，防止路径遍历（如../../etc/passwd） - 推荐生成唯一文件名（如
uuid.New().String() + filepath.Ext(header.Filename)），避免覆盖和冲突 - 务必关闭
src和dst文件句柄，否则高并发下容易触发too many open files
怎么限制上传大小和文件类型
Echo 默认不限制请求体大小，大文件上传可能耗尽内存或拖垮服务。必须在路由前加 e.Use(middleware.BodyLimit("5M"))，但注意：这个限制作用于整个请求体（包括 form 字段+文件），不是单个文件。
更精细的控制得靠手动判断：header.Size 是文件实际字节数，header.Header.Get("Content-Type") 可取 MIME 类型（但不可信，仅作参考）。
-
BodyLimit要设得比最大允许文件略大（比如文件上限 4MB，设"4.5M"），留出其他表单字段空间 - 用
filepath.Ext(header.Filename)判断扩展名比依赖Content-Type更可靠（浏览器可伪造后者） - 敏感类型如
.exe、.sh、.php应直接拒绝，返回c.String(http.StatusBadRequest, "unsupported file type") - 若需校验真实文件类型，可用
mimesniffer或读取文件头几个字节比对 magic number（小文件可行，大文件慎用）
为什么 c.SaveUploadedFile() 不推荐在生产环境直接用
Echo 提供了便捷方法 c.SaveUploadedFile(header, dst)，但它内部就是封装了 Open() + Copy()。问题在于它不校验目标路径、不处理并发写入冲突、也不做任何安全过滤 —— dst 参数若来自用户输入（比如 "./uploads/" + header.Filename），就等于把路径遍历漏洞直接暴露出来。
另外，它默认使用 os.Create(dst)，在 Windows 下可能因文件已存在而失败（Linux 会覆盖），且无法设置文件权限（如 0644）。
- 生产环境应自行实现保存逻辑，显式控制路径拼接、权限、重命名
- 若坚持用
SaveUploadedFile()，dst必须是硬编码路径或经严格白名单过滤的文件名 - 注意它的错误返回是
error，不是 Echo 的echo.HTTPError，需手动转换状态码
FormFile() 返回值是否为 nil。
