最常见原因是前端未使用enctype="multipart/form-data"提交且name不匹配：必须确保HTML表单含该属性，且与c.FormFile("avatar")参数严格一致（大小写敏感），否则返回nil或http.ErrMissingFile。
为什么c.FormFile()总返回nil或ErrMissingFile
最常见原因是前端没发对格式：必须用 enctype="multipart/form-data" 的表单提交，且 <input type="file" name="avatar"> 的 name 值要和 c.FormFile("avatar") 参数完全一致（大小写敏感）。如果前端用 fetch 发 FormData 却漏了 append("avatar", file)，或者用 application/json 传 base64 字符串，c.FormFile() 就一定失败，报 echo.ErrNotFound 或 http.ErrMissingFile。
- 先确认请求是否真正到达 handler：加
fmt.Printf("method=%s, url=%s\n", c.Request().Method, c.Request().URL) - 不确定字段名？调
c.MultipartForm()后打印form.File看 key 列表 -
c.FormFile()不会自动触发 multipart 解析；若之前没调过c.Request().ParseMultipartForm()，它可能返回 nil（尤其在自定义中间件后）
上传前必须设 BodyLimit，否则大文件直接 413 或 OOM
middleware.BodyLimit("10MB") 必须在路由注册前启用，否则 Echo 默认不限制请求体大小——不是“没效果”，而是大文件上传时进程内存暴涨、被系统 OOM kill，或代理（如 Nginx）静默截断，前端只看到空响应或 ERR_CONNECTION_ABORTED。
- 单位必须是字符串：
"50MB"✅，50 * 1024 * 1024❌ - 该限制作用于整个请求体（含 boundary + 所有表单字段），不是单个文件；设
"10MB"时，若表单还有 1MB 文本字段，实际允许的文件上限约 9MB - 若需更细粒度控制（比如只拦视频字段超 50MB），得在 handler 里手动读
file.Size并校验
保存文件不能直接 os.Create(header.Filename)
header.Filename 是用户可控输入，不做处理就拼路径等于开放任意文件写入。比如传 ../../etc/passwd，os.Create("./uploads/" + header.Filename) 就真写进系统关键位置。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 用
filepath.Base(header.Filename)剥离路径，只留原始文件名 - 生成唯一名：
uuid.New().String() + filepath.Ext(header.Filename) - 确保目录存在：
os.MkdirAll("./uploads", 0755)，别依赖手动创建 - 真正读取内容必须走
header.Open()得到io.ReadCloser，再用io.Copy(dst, src)；直接os.Create()写空文件再Write()会损坏二进制结构（图片/PDF 必乱）
怎么让上传后的文件能被 URL 访问
Echo 不自动提供静态文件服务。存完文件只是第一步，还得显式挂载静态路由，否则浏览器访问 /static/abc.jpg 会 404。
- 用
e.Static("/static", "./uploads")：URL 前缀/static映射到磁盘目录./uploads - 数据库里只存相对路径，比如
static/7f3a2b1e.png，拼上域名就是可访问 URL - 生产环境建议把
./uploads目录交给 Nginx 直接服务（更高效），此时 Echo 代码里仍按/static/xxx拼 URL，但不用e.Static() - 别硬编码
/var/www/html/uploads/—— 开发和生产路径不一致会导致本地测试通过、上线就 404
文件上传真正的复杂点不在“怎么存”，而在“怎么不让它存错”：路径遍历、类型绕过、大小失控、句柄泄漏、并发竞争……这些全得手动兜底，Echo 只提供轻量接口，不替你做安全决策。
