Golang如何实现基础的表单文件批量上传_Golang表单批量上传项目实战

P粉602998670 2025-11-23 00:00:00 次阅读

使用ParseMultipartForm解析multipart/form-data请求，设置32MB内存限制；2. 通过r.MultipartForm.File["files"]获取多个文件句柄；3. 遍历文件切片并复制内容到目标路径；4. 正确关闭文件句柄防止资源泄漏。

在Golang中实现基础的表单文件批量上传并不复杂，核心在于正确解析multipart/form-data请求，并安全地保存多个上传的文件。下面通过一个实战示例，展示如何用标准库完成这一功能。

接收HTML表单中的多文件上传

前端需要使用enctype="multipart/form-data"和multiple属性允许用户选择多个文件：

后端使用http.Request.ParseMultipartForm()解析请求体。关键点是调用r.MultipartForm.File获取同名字段下的多个文件句柄。

服务端处理批量文件的步骤

以下是Golang服务端的核心处理逻辑：

设置最大内存限制（如32MB），超出部分将缓存到临时文件
调用ParseMultipartForm解析请求
从r.MultipartForm.File["files"]获取文件切片
遍历每个文件，打开句柄并复制内容到目标路径
释放资源，防止内存泄漏

func uploadHandler(w http.ResponseWriter, r *http.Request) {
    if r.Method != "POST" {
        http.Error(w, "仅支持POST请求", http.StatusMethodNotAllowed)
        return
    }

    // 解析 multipart 表单，最大内存32MB
    err := r.ParseMultipartForm(32 << 20)
    if err != nil {
        http.Error(w, "解析表单失败", http.StatusBadRequest)
        return
    }

    files := r.MultipartForm.File["files"]

    for _, fileHeader := range files {
        // 打开上传的文件
        file, err := fileHeader.Open()
        if err != nil {
            http.Error(w, "无法打开文件", http.StatusInternalServerError)
            return
        }
        defer file.Close()

        // 创建本地保存的目标文件
        dst, err := os.Create("./uploads/" + fileHeader.Filename)
        if err != nil {
            http.Error(w, "创建文件失败", http.StatusInternalServerError)
            return
        }
        defer dst.Close()

        // 复制文件内容
        _, err = io.Copy(dst, file)
        if err != nil {
            http.Error(w, "保存文件失败", http.StatusInternalServerError)
            return
        }
    }

    w.Write([]byte("文件上传成功"))
}