应设置 e.MaxMultipartMemory = 64
如何用 echo.MultipartForm 正确解析上传的文件
Echo 框架本身不封装文件解析逻辑，而是依赖 Go 标准库的 http.Request.MultipartForm。直接调用 c.MultipartForm() 是最常用方式，但它会自动调用 ParseMultipartForm，而默认内存阈值只有 32MB —— 超过会报 http: request body too large 错误。
实操建议：
- 在路由注册前，全局设置最大内存限制：
e.MaxMultipartMemory = 64 - 调用
c.MultipartForm()前确保请求是POST且Content-Type为multipart/form-data，否则返回nil或 panic - 不要重复调用
c.MultipartForm()多次：第二次会返回已解析的缓存，但若第一次失败（如解析超时或格式错误），后续调用仍会失败 - 如果只上传小文件且无需额外字段，可跳过
MultipartForm，改用c.FormFile("file")更简洁
c.FormFile("name") 和 c.MultipartForm 怎么选
c.FormFile("name") 是 Echo 封装的快捷方法，底层调用 req.FormFile，适合单文件、字段名明确的场景；c.MultipartForm 返回完整 *multipart.Form，适合多文件 + 文本字段混合上传。
常见错误现象：
- 用
c.FormFile("avatar")却传了files[]数组名 → 返回nil, nil，无报错，容易漏判 - 用
c.MultipartForm后，从form.File["avatar"]取文件，但没检查len(form.File["avatar"]) > 0，直接取下标 panic - 文本字段（如
title）混在form.Value里，不是form.File，别错当成文件处理
保存上传文件时为什么总遇到 open /tmp/xxx: no such file or directory
这个错误通常不是路径问题，而是 file.Open() 返回的 multipart.File 是一个临时句柄，其底层文件可能已被标准库自动清理 —— 尤其当没及时读取或调用了 form.RemoveAll()。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
正确做法：
- 拿到
*multipart.FileHeader后，立刻用fileHeader.Open()打开，再用io.Copy写入目标路径，不要延迟 - 避免在 defer 中关闭
multipart.File：它不是普通 os.File，关闭后无法再读 - 写入前确保目标目录存在：
os.MkdirAll(filepath.Dir(dstPath), 0755)，否则os.Create会失败 - 别用
fileHeader.Size做唯一校验：它只是 header 声明大小，实际内容可能被截断，应以io.Copy返回字节数为准
前端传多个同名文件（files[]）怎么在 Echo 里接收
HTML 表单中 会生成多个同名 files[] 字段，但 Go 的 multipart.Form 不会自动合并为数组 —— 它把所有同名项塞进 form.File["files[]"] 切片里。
实操要点：
- 用
form.File["files[]"]获取切片，逐个遍历处理，不要用c.FormFile("files[]")（它只取第一个） - 注意字段名带
[]时，c.FormValue("files[]")会返回空字符串，文本字段必须用form.Value["field_name"] - 如果后端想统一处理“单文件 or 多文件”，建议前端固定用不同字段名（如
file和files），避免解析歧义
文件上传看似简单，但 multipart 解析时机、内存阈值、临时文件生命周期、同名字段语义这几个点，任意一个没对齐就会静默失败或报错难定位。尤其是 MaxMultipartMemory 和 form.RemoveAll() 的调用顺序，最容易被忽略。
