c.formfile 拿不到文件是因为前端未正确发送 multipart/form-data 请求或字段名不匹配；应流式处理文件、校验大小后再解析全部表单。
为什么 c.FormFile 拿不到文件？
常见现象是调用 c.FormFile("file") 返回 nil, err，且 err 为 http.ErrMissingFile。根本原因不是代码写错，而是前端没发对——Content-Type 必须是 multipart/form-data，且表单字段名（如 "file"）必须和后端 FormFile 参数完全一致。浏览器原生 <input type="file"> 默认满足，但用 fetch 或 axios 手动构造时，绝不能手动设置 Content-Type，否则浏览器会删掉边界标识（boundary），导致服务端无法解析 multipart。
如何安全读取并保存上传的文件？
别直接用 file.Open() 后 io.Copy 到磁盘——这会让整个文件加载进内存，大文件容易 OOM。Echo 的 multipart.File 实际是 io.ReadCloser，应流式处理：
- 先用
c.FormFile("file")获取*multipart.FileHeader，检查Size是否超限（例如限制 10MB：if header.Size > 10*1024*1024） - 调用
header.Open()得到io.ReadCloser，立即用os.Create打开目标文件，再io.Copy(dst, src) - 务必用
defer file.Close()和defer dst.Close()，否则句柄泄漏
示例关键片段：
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
file, err := c.FormFile("file")
if err != nil {
return c.String(400, "no file received")
}
if file.Size > 10*1024*1024 {
return c.String(400, "file too large")
}
src, _ := file.Open()
defer src.Close()
dst, _ := os.Create("/tmp/" + file.Filename)
defer dst.Close()
io.Copy(dst, src)
多个文件或混合表单字段怎么处理？
c.FormFile 只取第一个同名文件；要取全部，改用 c.MultipartForm()。它返回 *multipart.Form，其中 form.File 是 map[string][]*multipart.FileHeader，form.Value 是普通文本字段（如 form.Value["username"]）。注意：调用 MultipartForm() 会一次性把整个 multipart body 解析进内存，所以必须在检查文件大小之后再调用——否则攻击者可发超大 body 绕过 size 校验。
- 先遍历
c.Request().MultipartReader().NextPart()手动读取每个 part，按part.FormName()区分文件/字段，并实时校验文件大小 - 或者，先用
c.Request().ParseMultipartForm(32 设置内存上限（如 32MB），再调用 <code>c.MultipartForm() - 混合场景下，
form.Value里的值是[]string，即使单值也要取[0]
为什么上传大文件时连接被重置？
默认情况下，Go HTTP server 的 ReadTimeout 和 Echo 的 MaxRequestBodySize 都可能触发中断。前者控制整个请求读取时限（含传输时间），后者控制 body 大小硬限制。两者都要调：
e := echo.New()
e.MaxRequestBodySize = 100 * 1024 * 1024 // 100MB
e.HTTPErrorHandler = func(err error, c echo.Context) {
if errors.Is(err, http.ErrBodyReadAfterClose) {
// 客户端提前断连，忽略
return
}
// 其他错误正常处理
}同时，启动 server 时显式配置 http.Server：srv := &http.Server{
Addr: ":8080",
Handler: e,
ReadTimeout: 30 * time.Second,
WriteTimeout: 60 * time.Second,
}注意：如果用 Nginx 反向代理，还得调它的 client_max_body_size 和 proxy_read_timeout，否则请求根本到不了 Echo。
