Golang如何搭建文件上传与下载服务_Golang 文件传输服务实践-Golang-PHP中文网

Golang如何搭建文件上传与下载服务_Golang 文件传输服务实践

P粉602998670

发布： 2025-11-23 17:44:40

原创

920人浏览过

首先实现文件上传接口，通过ParseMultipartForm解析multipart/form-data请求，限制内存使用32MB，提取文件并保存；接着实现下载功能。

golang如何搭建文件上传与下载服务_golang 文件传输服务实践

在Go语言中搭建一个高效的文件上传与下载服务并不复杂。利用标准库中的 net/http 和文件操作功能，可以快速实现稳定、安全的文件传输服务。下面从基础结构出发，介绍如何构建一个支持文件上传与下载的HTTP服务，并给出实际可运行的代码示例。

1. 实现文件上传接口

文件上传的核心是处理 multipart/form-data 类型的请求。Go 的 http.Request 提供了 ParseMultipartForm 方法来解析表单数据，包括文件字段。

以下是一个简单的文件上传处理函数：

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
    }

    file, handler, err := r.FormFile("file")
    if err != nil {
        http.Error(w, "获取文件失败", http.StatusBadRequest)
        return
    }
    defer file.Close()

    // 创建本地文件用于保存上传内容
    dst, err := os.Create("./uploads/" + handler.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.WriteHeader(http.StatusOK)
    w.Write([]byte("文件上传成功: " + handler.Filename))
}

登录后复制

注意点：

立即学习“go语言免费学习笔记（深入）”；

确保 ./uploads 目录存在，否则创建失败
限制上传大小防止恶意攻击
对文件名做安全校验，避免路径穿越（如：../../../etc/passwd）

2. 实现文件下载接口

文件下载本质上是读取服务器上的文件并通过 HTTP 响应返回，设置正确的响应头让浏览器触发下载行为。

Looka

AI辅助Logo和品牌设计工具

894

查看详情

示例如下：

func downloadHandler(w http.ResponseWriter, r *http.Request) {
    filename := r.URL.Query().Get("file")
    if filename == "" {
        http.Error(w, "缺少文件名参数", http.StatusBadRequest)
        return
    }

    filepath := "./uploads/" + filename

    // 检查文件是否存在且不包含非法路径
    if !strings.HasPrefix(filepath, "./uploads/") {
        http.Error(w, "非法路径", http.StatusForbidden)
        return
    }

    _, err := os.Stat(filepath)
    if os.IsNotExist(err) {
        http.Error(w, "文件不存在", http.StatusNotFound)
        return
    }

    // 设置响应头，触发浏览器下载
    w.Header().Set("Content-Disposition", "attachment; filename="+filename)
    w.Header().Set("Content-Type", "application/octet-stream")

    http.ServeFile(w, r, filepath)
}

登录后复制

关键点：

验证文件路径合法性，防止目录遍历攻击
使用 Content-Disposition: attachment 强制下载
大文件可考虑分块传输或使用 io.Copy 控制缓冲

3. 启动HTTP服务并路由

将上传和下载处理函数注册到路由，并启动服务：

func main() {
    // 确保上传目录存在
    os.MkdirAll("./uploads", os.ModePerm)

    http.HandleFunc("/upload", uploadHandler)
    http.HandleFunc("/download", downloadHandler)

    // 可选：提供静态页面用于测试上传
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        html := `
        <html>
        <body>
            <form enctype="multipart/form-data" action="/upload" method="post">
                <input type="file" name="file" />
                <input type="submit" value="上传" />
            </form>
        </body>
        </html>
        `
        w.Write([]byte(html))
    })

    println("服务已启动，访问 http://localhost:8080")
    log.Fatal(http.ListenAndServe(":8080", nil))
}

登录后复制

这样就完成了一个基本可用的文件传输服务。