必须显式使用middleware.bodylimit()限制请求体大小，echo默认不限制，否则大文件上传会导致oom或连接中断；需在路由注册前启用，单位为字符串格式（如"50mb"），并配合c.formfile()、安全重命名及c.file()服务响应url。
上传接口必须显式限制请求体大小
默认情况下 Echo 不限制 POST 或 PUT 请求体大小，大文件上传可能耗尽内存或触发连接中断。不设限的后果不是报错，而是进程 OOM 或被代理（如 Nginx）静默截断，前端表现为 ERR_CONNECTION_ABORTED 或空响应。
正确做法是使用 middleware.BodyLimit() 中间件，在路由注册前启用：
e.Use(middleware.BodyLimit("50MB"))
注意单位必须是字符串格式（"10MB"、"2G"），不能写成数字；该限制作用于整个请求体（含 multipart boundary 和所有字段），不是单个文件大小。
- 若需更细粒度控制（例如仅限制文件字段），得在 handler 内手动校验
form.File["video"]的Size - 值设太大（如
"2G"）可能掩盖真实瓶颈，建议按业务最大允许文件反推，留 20% 余量 - 该中间件必须放在
middleware.Logger()之前，否则日志可能记录不全
用 c.FormFile() 而非 c.MultipartForm() 处理单文件
多数上传场景（头像、视频、PDF）都是单文件，但开发者常误用 c.MultipartForm() 全量解析——它会把所有文件和表单字段一次性读入内存，即使只取一个字段也浪费资源。
c.FormFile("video") 是轻量替代：它只定位并打开指定字段对应的文件句柄，不加载内容，后续可流式处理：
file, err := c.FormFile("video")
if err != nil {
return c.JSON(http.StatusBadRequest, map[string]string{"error": "no video field"})
}
src, _ := file.Open()
defer src.Close()
// 直接 io.Copy 到磁盘或云存储，不进内存
dst, _ := os.Create("./uploads/" + file.Filename)
io.Copy(dst, src)
-
file.Size是可信的，来自 multipart header，无需先读文件再os.Stat() - 若前端用
fetch发送FormData，字段名必须与后端c.FormFile()参数严格一致（区分大小写） - 不校验
file.Header.Get("Content-Type")就直接保存，可能造成恶意类型绕过（如上传 .php 文件）
文件名与路径必须做安全过滤
用户可控的 filename 是典型攻击入口。直接拼接 path.Join("uploads", filename) 可被 ../../../etc/passwd 绕过，导致任意文件写入。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
基础防护只需两步：
- 拒绝含
".."或开头为"/"的文件名（strings.Contains(filename, "..") || strings.HasPrefix(filename, "/")） - 强制重命名：用 UUID 或哈希生成新文件名，保留原始扩展名（
ext := path.Ext(file.Filename); newname := uuid.New().String() + ext）
不要依赖 filepath.Clean() 做净化——它无法阻止空字节、Unicode 归一化等绕过手段；也不要信任前端传来的 Content-Type，MIME 类型校验应基于文件魔数（http.DetectContentType() 读前 512 字节）。
上传完成后返回结构需包含可播放的 URL
纯返回 {"success": true} 对前端不友好。视频上传后，客户端通常要立即预览或插入播放器，所以响应体应带可访问地址：
return c.JSON(http.StatusOK, map[string]string{
"url": "/videos/" + newname,
"filename": file.Filename,
"size": strconv.FormatInt(file.Size, 10),
})
这个 /videos/xxx.mp4 路由必须用 c.File() 实现，而非 e.Static() —— 后者不支持 Accept-Ranges，会导致视频进度条拖动失败、Seek 失效。
容易忽略的是：如果部署在反向代理后（如 Nginx），需确保代理透传 Range、If-Range 等头，并关闭缓存（proxy_buffering off），否则 c.File() 的断点续传能力会被阉割。
