使用 Go 处理多文件上传-Golang-PHP中文网

使用 Go 处理多文件上传

霞舞

发布： 2025-10-01 16:34:47

原创

609人浏览过

使用 go 处理多文件上传

在 Go 语言中处理 HTTP 请求时，http.Request 结构体提供了方便的方法来访问表单数据。然而，当涉及到多文件上传时，FormFile 函数的局限性就显现出来了。该函数只能返回指定表单键的第一个文件。为了处理包含多个文件的表单，我们需要更深入地了解 MultipartForm 的工作原理。

解析 MultipartForm

首先，我们需要使用 req.ParseMultipartForm() 方法解析 multipart 表单数据。该方法会读取请求体，并将文件和字段存储在 req.MultipartForm 结构体中。你需要指定一个内存大小限制，这决定了文件在内存中存储的最大大小。超过此限制的文件将被写入磁盘上的临时文件。FormFile 函数默认使用 32MB 的限制，所以我们推荐使用相同的值，以保持一致性。

req.ParseMultipartForm(32 << 20) // 32MB

登录后复制

访问文件列表

解析完成后，我们可以通过 req.MultipartForm.File 字段访问所有上传的文件。这是一个 map[string][]*multipart.FileHeader 类型的映射，其中键是表单中 input 标签的 name 属性，值是与该名称关联的所有文件的 FileHeader 切片。

例如，如果 HTML 表单包含以下 input 标签：

<input type="file" name="myfiles" multiple="multiple">

登录后复制

我们可以通过 req.MultipartForm.File["myfiles"] 获取所有上传的文件。

处理单个文件

易森网络企业版

如果您是新用户，请直接将本程序的所有文件上传在任一文件夹下，Rewrite 目录下放置了伪静态规则和筛选器，可将规则添加进IIS，即可正常使用，不用进行任何设置；(可修改图片等)默认的管理员用户名、密码和验证码都是：yeesen系统默认关闭，请上传后登陆后台点击“核心管理”里操作如下:进入“配置管理”中的&ld

查看详情

获取 FileHeader 切片后，我们可以遍历它来访问每个单独的文件。对于每个 FileHeader，我们可以使用 fh.Open() 方法打开文件。这将返回一个 io.ReadCloser 接口，我们可以从中读取文件内容。

fhs := req.MultipartForm.File["myfiles"]
for _, fh := range fhs {
    f, err := fh.Open()
    if err != nil {
        // 处理错误
        fmt.Println("Error opening file:", err)
        continue
    }
    defer f.Close()

    // 现在你可以从 'f' 中读取文件内容
    // 例如，将文件内容复制到另一个文件：
    // io.Copy(dst, f)
}

登录后复制

完整示例代码

下面是一个完整的示例代码，展示了如何处理多文件上传：

package main

import (
    "fmt"
    "io"
    "log"
    "net/http"
    "os"
)

func uploadHandler(w http.ResponseWriter, r *http.Request) {
    // 解析 multipart form，限制为 32MB
    err := r.ParseMultipartForm(32 << 20)
    if err != nil {
        http.Error(w, err.Error(), http.StatusBadRequest)
        return
    }

    // 获取名为 "myfiles" 的文件列表
    files := r.MultipartForm.File["myfiles"]
    if len(files) == 0 {
        fmt.Fprintln(w, "No files uploaded")
        return
    }

    // 遍历文件列表
    for _, fileHeader := range files {
        // 打开文件
        file, err := fileHeader.Open()
        if err != nil {
            http.Error(w, err.Error(), http.StatusInternalServerError)
            return
        }
        defer file.Close()

        // 创建一个新文件来保存上传的文件
        dst, err := os.Create("./uploads/" + fileHeader.Filename) // 建议添加路径安全检查
        if err != nil {
            http.Error(w, err.Error(), http.StatusInternalServerError)
            return
        }
        defer dst.Close()

        // 将上传的文件内容复制到新文件中
        if _, err := io.Copy(dst, file); err != nil {
            http.Error(w, err.Error(), http.StatusInternalServerError)
            return
        }

        fmt.Fprintf(w, "Uploaded file: %s\n", fileHeader.Filename)
    }
}

func main() {
    http.HandleFunc("/upload", uploadHandler)
    log.Println("Server listening on port 8080")
    log.Fatal(http.ListenAndServe(":8080", nil))
}

登录后复制

注意事项

安全: 请务必对上传的文件名进行验证和清理，以防止路径遍历攻击。不要直接使用客户端提供的文件名，而是生成随机文件名或使用白名单验证。
错误处理: 在实际应用中，需要更完善的错误处理机制，例如记录错误日志、向用户显示友好的错误信息等。
存储: 本示例将文件保存在本地文件系统中。在生产环境中，你可能需要将文件存储在云存储服务（如 Amazon S3、Google Cloud Storage）或数据库中。
资源释放: 务必使用 defer 语句关闭打开的文件，以确保资源得到及时释放。
文件大小限制: 根据你的应用需求，可以调整 ParseMultipartForm 方法的内存大小限制。