首页 > Golang > Go教程

Golang文件上传与存储实现教程

时间：2025-12-22 10:46:24 244浏览收藏

推广推荐

支持 PC / 移动端，安全直达

今天golang学习网给大家带来了《Golang文件上传实现与存储示例》，其中涉及到的知识点包括等等，无论你是小白还是老手，都适合看一看哦~有好的建议也欢迎大家在评论留言，若是看完有所收获，也希望大家能多多点赞支持呀！一起加油学习~

Go语言通过net/http和multipart/form-data实现文件上传，需前端表单enctype为multipart/form-data；后端用r.ParseMultipartForm解析，r.FormFile获取文件，os.Create保存，并校验大小、类型、扩展名及路径安全，推荐重命名防攻击，文件存至指定目录如./uploads。

Golang如何实现文件上传功能_Golang文件上传处理与存储示例

在Go语言中实现文件上传功能并不复杂，借助标准库 net/http 和 multipart/form-data 解析能力，可以轻松处理客户端上传的文件。下面是一个完整的Golang文件上传处理与存储示例，涵盖前端表单、后端接收、文件保存和安全校验等关键环节。

1. 前端HTML表单支持文件上传

要上传文件，前端需要一个支持 multipart 的表单：

注意：enctype="multipart/form-data" 是必须的，否则文件无法正确传输。

2. 后端使用Golang接收并保存文件

使用 net/http 处理上传请求，调用 r.ParseMultipartForm() 解析 multipart 数据，再通过 r.FormFile() 获取文件句柄。

示例代码：

package main

import (
  "fmt"
  "io"
  "net/http"
  "os"
  "path/filepath"
)

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
  }

  // 获取上传的文件字段（对应HTML中的 name="file"）
  file, handler, err := r.FormFile("file")
  if err != nil {
    http.Error(w, "获取文件失败", http.StatusBadRequest)
    return
  }
  defer file.Close()

  // 可选：获取其他表单字段
  title := r.FormValue("title")
  fmt.Printf("收到文件: %s, 标题: %s\n", handler.Filename, title)

  // 创建保存目录
  uploadDir := "./uploads"
  os.MkdirAll(uploadDir, os.ModePerm)

  // 构造保存路径，防止路径穿越攻击
  filename := filepath.Base(handler.Filename)
  dstPath := filepath.Join(uploadDir, filename)

  // 创建目标文件
  dst, err := os.Create(dstPath)
  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
  }

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

func main() {
  http.HandleFunc("/upload", uploadHandler)
  http.Handle("/", http.FileServer(http.Dir("."))) // 提供HTML页面
  fmt.Println("服务启动在 :8080")
  http.ListenAndServe(":8080", nil)
}

3. 安全与优化建议

实际项目中，需加入以下保护措施：

限制文件大小：在 ParseMultipartForm 中设置合理上限，如 32MB
校验文件类型：读取前几个字节判断 MIME 类型，避免执行恶意文件
重命名文件：使用 UUID 或时间戳重命名，防止覆盖和路径注入
检查扩展名：禁止 .php、.sh 等可执行后缀
防路径穿越：使用 filepath.Clean 和 Base 过滤 ../ 等非法路径

例如，使用随机文件名：

import "crypto/rand"

func generateFilename(ext string) string {
  b := make([]byte, 16)
  rand.Read(b)
  return fmt.Sprintf("%x%s", b, ext)
}

4. 测试运行

将上述 Go 程序与 HTML 页面放在同一目录，运行程序后访问 http://localhost:8080，即可看到上传表单。提交后文件会保存到 ./uploads 目录。

基本上就这些。Golang的文件上传处理简洁高效，适合构建API服务或后台管理系统中的附件上传功能。

终于介绍完啦！小伙伴们，这篇关于《Golang文件上传与存储实现教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！