文件上传必须用POST或PUT，不能用GET；路由需显式声明为app.Post("/upload", handler)，c.FormFile("name")的name必须与HTML input的name属性完全一致，大小写敏感，多文件需用c.MultipartForm()遍历，保存路径须用绝对路径并手动创建父目录。
文件上传必须用 POST 或 PUT，不能靠 GET 模拟
Fiber 不解析 GET 请求的表单数据，c.FormFile() 在 GET 路由里永远返回 nil。浏览器原生 也不支持文件字段，提交会被忽略。真要上传，路由必须显式声明为 POST 或 PUT：
-
app.Post("/upload", handler)是标准写法 -
app.Put("/upload/:id", handler)适用于带路径参数的更新场景 - 别写
app.Get("/upload", ...)—— 即使前端用 JS 拼了 FormData，后端也拿不到文件
c.FormFile("name") 的 name 必须和 HTML
这个字符串不是随意起的，它对应 HTTP multipart 表单里的 name 字段。大小写、下划线、空格都敏感：
- HTML 写
→ 后端必须用c.FormFile("avatar") - 写成
c.FormFile("Avatar")或c.FormFile("avatar_img")都会返回nil，且不报错 - 多文件时，如果前端用
name="files"并设multiple，后端得用c.MultipartForm()手动遍历，c.FormFile()只取第一个
上传路径必须注册在 app.Group("/api") 之后，且不能重复拼接前缀
用分组管理上传接口很常见，但新手常在这里翻车：分组本身不改路径逻辑，只是提供一个新路由实例。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- ✅ 正确：
api := app.Group("/api"); api.Post("/upload", handler)→ 匹配POST /api/upload - ❌ 错误：
api := app.Group("/api"); api.Post("/api/upload", handler)→ 实际注册为/api/api/upload - ⚠️ 注意：如果上传接口需要鉴权中间件，必须挂到 group 上：
api.Use(authMiddleware)，而不是app.Use("/api", ...)—— 后者对所有方法生效，但无法区分上传和其他 API 的权限逻辑
c.SaveFile() 的保存路径是相对当前工作目录，不是二进制所在目录
Fiber 运行时的当前工作目录（os.Getwd()）决定 c.SaveFile(file, "./uploads/xxx") 的落盘位置。这和 Go 编译产物的位置无关，上线后容易因部署方式不同导致文件“消失”。
- 推荐用绝对路径：
filepath.Join(os.Getenv("UPLOAD_DIR"), file.Filename)，并启动前检查该目录可写 - 别直接用
"./uploads/" + file.Filename—— Docker 容器或 systemd 服务里，工作目录可能不是你预期的项目根目录 -
c.SaveFile()不自动创建父目录，os.MkdirAll()得自己调；漏掉就报no such file or directory
Fiber 的文件上传没魔法，每一步都依赖 HTTP 规范和明确的路径/字段对齐。最容易被忽略的是：上传接口上线前必须用 curl -F 或 Postman 真实发一次 multipart 请求验证，光跑单元测试或 mock c.FormFile 会掩盖路径、字段名、权限中间件等真实链路问题。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
