当前位置：首页 > 文章列表 > Golang > Go教程 > Golang文件上传与存储实现教程

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

2026-03-23 14:51:31 0浏览收藏

本文详细讲解了如何在Go语言中安全、高效地实现文件上传功能，涵盖前端HTML表单配置（关键在于设置enctype="multipart/form-data"）、后端使用net/http和multipart标准库解析请求、读取文件流、校验文件大小/类型/扩展名及路径安全性，并通过重命名和指定存储目录（如./uploads）防范常见攻击，是一份兼顾实用性与安全性的完整入门到落地的Golang文件上传教程。

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