如何用Golang Fiber框架处理文件上传-Golang-PHP中文网

c.formfile拿不到文件的根本原因是请求未发成multipart/form-data或字段名不匹配：前端需设enctype="multipart/form-data"且input name与c.formfile("xxx")参数严格一致（区分大小写）。

如何用golang fiber框架处理文件上传

为什么 `c.FormFile` 拿不到文件？

常见现象是调用 c.FormFile("file") 返回 nil, nil 或 nil, err（http.ErrMissingFile），但前端明明传了。根本原因只有两个：请求没发成 multipart/form-data，或 表单字段名对不上。

检查点：

前端 <form></form> 必须带 enctype="multipart/form-data"，用 fetch 时不能直接传 JSON 对象，得用 FormData 实例
后端 FormFile 的参数名（如 "file"）必须和 HTML input name="file" 或 fetch 中 formData.append("file", file) 的键完全一致，区分大小写
Fiber 默认限制单个请求体最大 4MB，超限会静默丢弃文件——需显式配置 fiber.Config{BodyLimit: "20MB"}

怎么安全地保存上传的文件？

别直接用 file.Filename 当本地路径名，它来自客户端，可能含 ../、空字节、控制字符，甚至恶意扩展名。Fiber 不做任何过滤，全靠你自己处理。

实操建议：

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

用 filepath.Base(file.Filename) 截掉路径遍历部分，再用正则或白名单校验文件名（比如只允许 ^[a-zA-Z0-9._-]+$）
不要信任 file.Header.Get("Content-Type")，它可被伪造；用 file.Open() 读前几个字节，调用 http.DetectContentType 做 MIME 类型检测
保存时生成随机文件名（如 uuid.New().String() + ".jpg"），保留原始扩展名仅当 MIME 类型匹配且在白名单内（如 image/jpeg → .jpg）
写入前确保目标目录存在：os.MkdirAll("./uploads", 0755)

`c.SaveFile` 和手动 `file.Open` + `io.Copy` 有什么区别？

c.SaveFile 是 Fiber 封装的快捷方法，底层也是打开源文件流并拷贝，但它省略了错误分支和中间控制——适合开发期快速验证，不推荐上线使用。

手动处理更可控：

能逐块读取并实时校验内容（比如限制图片尺寸、扫描病毒特征）
可配合 io.LimitReader 防止恶意大文件耗尽内存（file.Size 可信，但仅表示客户端声称的大小）
出错时能返回具体 HTTP 状态码，比如 413 Payload Too Large 或 422 Unprocessable Entity

示例关键片段：

src, err := file.Open()
if err != nil {
    return c.Status(fiber.StatusBadRequest).SendString("cannot open upload")
}
defer src.Close()

dst, err := os.Create("./uploads/" + safeName)
if err != nil {
    return c.Status(fiber.StatusInternalServerError).SendString("save failed")
}
defer dst.Close()

if _, err = io.Copy(dst, io.LimitReader(src, file.Size)); err != nil {
    return c.Status(fiber.StatusInternalServerError).SendString("write failed")
}

并发上传多个文件时要注意什么？

用 c.MultipartForm() 获取全部文件，而不是反复调用 c.FormFile——后者每次都会重新解析整个 multipart body，性能差且可能失败。

注意点：

MultipartForm 返回的 *multipart.Form 中，File 字段是 map[string][]*multipart.FileHeader，同一个字段名（如 "images"）可能对应多个文件
每个 *multipart.FileHeader 都要单独 Open()，不能复用句柄
大量并发上传时，注意系统文件描述符上限；可考虑加限流中间件（如 fiber.Limiter）或异步落盘（写入消息队列）
临时文件默认存在 /tmp，如果磁盘空间紧张或挂载为 noexec，会导致 Open 失败，可通过 os.Setenv("TMPDIR", "/path/to/writable") 提前指定