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

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

P粉602998670

发布： 2025-12-15 17:30:07

原创

172人浏览过

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() 获取文件句柄。

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

示例代码：

FashionLabs

AI服装模特、商品图，可商用，低价提升销量神器

查看详情

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