Golang文件上传与下载功能实现-Golang-PHP中文网

Golang文件上传与下载功能实现

P粉602998670

发布： 2025-09-08 09:43:01

原创

179人浏览过

首先实现文件上传与下载功能，通过net/http解析multipart表单获取文件并保存；其次设置响应头触发浏览器下载，防止路径穿越；最后通过限制大小、校验类型、使用随机命名等措施保障安全。

golang文件上传与下载功能实现

实现文件上传与下载功能在Golang中非常常见，尤其在构建Web服务时。通过标准库

net/http

登录后复制

和

os

登录后复制

等，可以轻松完成这些操作。下面介绍如何实现一个简洁、安全、可扩展的文件上传与下载服务。

文件上传处理

文件上传的核心是解析HTTP请求中的multipart/form-data数据，提取上传的文件并保存到服务器指定目录。

关键步骤包括：

使用
```
http.Request
```
登录后复制
的
```
ParseMultipartForm
```
登录后复制
方法解析请求体
通过
```
FormFile
```
登录后复制
获取上传的文件句柄
使用
```
os.Create
```
登录后复制
创建目标文件，并用
```
io.Copy
```
登录后复制
将上传内容写入磁盘
设置合理的内存和磁盘大小限制，防止恶意大文件攻击

示例代码片段：

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

    // 解析multipart表单，最大内存10MB
    r.ParseMultipartForm(10 << 20)

    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()

    // 复制文件内容
    io.Copy(dst, file)
    fmt.Fprintf(w, "文件 %s 上传成功", handler.Filename)
}

登录后复制

文件下载实现

文件下载的关键是设置正确的响应头，让浏览器触发下载行为，而不是直接显示内容。

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

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

主要操作包括：

验证请求的文件名，防止路径穿越攻击（如 ../../etc/passwd）
使用
```
os.Open
```
登录后复制
打开文件
设置
```
Content-Disposition
```
登录后复制
头为attachment模式
设置
```
Content-Type
```
登录后复制
为
```
application/octet-stream
```
登录后复制
以强制下载
使用
```
http.ServeContent
```
登录后复制
安全地发送文件流

示例代码片段：

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

    // 简单路径安全检查
    if strings.Contains(filename, "..") || strings.Contains(filename, "/") {
        http.Error(w, "非法文件名", http.StatusBadRequest)
        return
    }

    path := "./uploads/" + filename
    file, err := os.Open(path)
    if err != nil {
        http.Error(w, "文件不存在", http.StatusNotFound)
        return
    }
    defer file.Close()

    // 设置响应头
    w.Header().Set("Content-Disposition", "attachment; filename="+filename)
    w.Header().Set("Content-Type", "application/octet-stream")

    http.ServeContent(w, r, filename, time.Now(), file)
}

登录后复制