不能只靠BodyLimit控制上传大小，因其仅限制请求体总字节数，不区分文件与表单字段；攻击者可构造小文本字段+超大文件绕过限制，必须用file.Size校验单个文件真实大小。
直接用 e.Use(middleware.BodyLimit("2M")) + c.FormFile() 就能处理绝大多数上传场景，但必须同步校验文件名、大小、MIME 类型和存储路径，否则会触发路径遍历、磁盘爆满或恶意代码执行。
为什么不能只靠 BodyLimit 控制上传大小
middleware.BodyLimit 只限制整个请求体（含表单字段+文件）的总字节数，不区分文件内容；若用户构造一个 1MB 的文本字段 + 99MB 的文件，只要总和 ≤ 阈值就会放行。真正控制单个文件大小，得在 c.FormFile() 后立刻检查 file.Size。
- BodyLimit 是第一道防线，防 DoS 攻击，建议设为略大于业务最大文件（如视频上传设
"50M"） - FormFile 返回的
*multipart.FileHeader才带真实文件元信息，file.Size是准确字节数，file.Header.Get("Content-Type")是客户端声明的 MIME - 别信
file.Header.Get("Content-Type")—— 它可被任意篡改，必须用net/http/sniff实际读取前 512 字节做类型检测
文件名与路径安全校验必须手动做
Echo 不自动过滤文件名，c.FormFile("avatar") 拿到的 file.Filename 可能是 ../../../etc/passwd 或带 null 字节的字符串。不校验就直接 os.Create(filepath.Join(uploadDir, file.Filename))，等于开放服务器写权限。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 用
filepath.Base(file.Filename)截掉所有路径部分，只保留原始文件名 - 用正则
^[a-zA-Z0-9._-]+$过滤非法字符（禁止/、\0、控制字符） - 存储时不要复用原名，生成唯一 ID：
uuid.New().String() + filepath.Ext(file.Filename) - 上传目录必须是绝对路径且不在 Web 根目录下，避免用户通过 URL 直接访问
内存 vs 临时文件：大文件上传的两种模式
c.FormFile() 默认将小文件（file.Open() 返回的 io.ReadCloser 在 handler 返回后自动关闭 —— 若你启用了异步处理（如上传后触发转码），必须立刻 io.Copy 到持久化位置，否则句柄失效。
- 想全程流式处理（比如边上传边推送到 MinIO），用
c.MultipartForm()获取*multipart.Form，遍历form.File并对每个file.Open()做实时处理 - 想存本地，优先调
file.Open()再io.Copy(dst, src)，别用file.WriteTo()—— 它不保证原子性，断电可能留下损坏文件 - 临时文件默认存在
os.TempDir()，生产环境应显式设置os.Setenv("TMPDIR", "/mnt/fasttmp")指向 SSD 盘
常见错误现象与修复点
上传接口返回 400 却没日志、前端卡在 loading、文件内容乱码、同一文件多次上传覆盖 —— 这些基本都源于中间件配置与 handler 协作断裂。
-
http: request body too large：没配middleware.BodyLimit或值太小，不是框架 bug - Chrome 显示
net::ERR_CONNECTION_RESET：handler 处理超时（默认 30 秒），大文件上传需调大e.Server.ReadTimeout和反向代理（Nginx）的client_max_body_size、proxy_read_timeout - 文件名中文变
%E4%BD%A0%E5%A5%BD：没设响应头c.Response().Header().Set("Content-Disposition", "attachment; filename*=UTF-8''"+url.PathEscape(name)) - 并发上传同名文件冲突：别依赖原文件名，强制用 UUID 重命名
最易被忽略的是：上传完成后的清理动作。临时文件不会自动删除，file.Open() 返回的 io.ReadCloser 关闭后，底层临时文件仍驻留磁盘，得靠系统定时清理或自己调 os.Remove(file.Header.Filename) —— 但注意，这仅适用于 file.Header.Filename 指向临时路径的情况，别误删业务文件。
