如何在Golang中实现Web文件上传与下载_Golang Web文件操作实践技巧-Golang-PHP中文网

如何在Golang中实现Web文件上传与下载_Golang Web文件操作实践技巧

P粉602998670

发布： 2025-12-07 14:58:02

原创

577人浏览过

Golang中可基于net/http和mime/multipart实现安全的Web文件上传下载。需使用multipart/form-data表单，调用ParseMultipartForm解析，通过io.Copy保存文件并及时关闭句柄。

如何在golang中实现web文件上传与下载_golang web文件操作实践技巧

在Golang中实现Web文件上传与下载并不复杂，关键在于正确处理HTTP请求、解析表单数据以及安全地操作文件系统。通过标准库net/http和mime/multipart，我们可以高效完成这些功能，无需引入第三方框架。

实现文件上传

文件上传依赖于HTML表单的multipart/form-data编码类型。后端需解析这种格式的请求体，并将上传的文件保存到指定路径。

步骤说明：

使用http.PostFormFile或r.ParseMultipartForm()解析上传内容
从multipart.Form中获取文件句柄
使用io.Copy将文件流写入本地磁盘
及时关闭文件句柄避免资源泄漏

示例代码：

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

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

  r.ParseMultipartForm(32   file, handler, err := r.FormFile("uploadFile")
  if err != nil {
    http.Error(w, "无法读取上传文件", http.StatusBadRequest)
    return
  }
  defer file.Close()

  out, err := os.Create("./uploads/" + handler.Filename)
  if err != nil {
    http.Error(w, "无法创建文件", http.StatusInternalServerError)
    return
  }
  defer out.Close()

  _, err = io.Copy(out, file)
  if err != nil {
    http.Error(w, "写入文件失败", http.StatusInternalServerError)
    return
  }

  fmt.Fprintf(w, "文件 %s 上传成功", handler.Filename)
}

实现文件下载

文件下载的核心是设置正确的响应头，告诉浏览器以附件形式处理响应内容，从而触发下载行为。

厉害猫AI

遥遥领先的AI全职业办公写作平台

137

查看详情

关键点：

使用w.Header().Set("Content-Disposition", "attachment; filename=...")指定下载文件名
设置Content-Type为application/octet-stream表示二进制流
读取本地文件并写入响应体
注意路径安全，防止目录遍历攻击（如用户请求 ../../etc/passwd）

示例代码：

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

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

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

  filepath := "./uploads/" + filename
  _, 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)
}