使用Go的mime/multipart包可解析multipart请求实现文件上传。1. 设置表单enctype为multipart/form-data，通过r.ParseMultipartForm解析；2. 使用r.FormFile获取文件，io.Copy保存；3. 校验文件类型、大小，重命名防攻击。结合net/http处理请求，确保安全与稳定性。
在Web开发中，文件上传是常见需求。Go语言标准库提供了 mime/multipart 包，专门用于处理multipart格式的HTTP请求，比如包含文件和表单字段的POST请求。本文将介绍如何使用Golang解析multipart请求实现文件上传，并给出实际可运行的示例。
理解 multipart/form-data
当HTML表单设置 enctype="multipart/form-data" 时，浏览器会将表单数据以多部分（multipart）的形式发送。每一部分可以是文本字段或文件内容，彼此通过边界（boundary）分隔。
例如，一个包含用户名和头像上传的表单，请求体大致如下：
--abc123Content-Disposition: form-data; name="username"
张三
--abc123
Content-Disposition: form-data; name="avatar"; filename="photo.jpg"
Content-Type: image/jpeg
（二进制图片数据）
--abc123--
使用 net/http 和 mime/multipart 处理上传
Go中处理文件上传的核心步骤是：解析请求、读取multipart数据、保存文件。以下是一个完整的服务端处理示例：
立即学习“go语言免费学习笔记（深入）”；
1. 创建HTTP处理函数
func uploadHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "仅支持POST方法", http.StatusMethodNotAllowed)
return
}
// 解析multipart表单，最大内存10MB
err := r.ParseMultipartForm(10 if err != nil {
http.Error(w, "解析表单失败", http.StatusBadRequest)
return
}
// 获取文件字段 "file"
file, handler, err := r.FormFile("file")
if err != nil {
http.Error(w, "获取文件失败", http.StatusBadRequest)
return
}
defer file.Close()
// 创建本地文件用于保存
f, err := os.OpenFile("./uploads/"+handler.Filename, os.O_WRONLY|os.O_CREATE, 0666)
if err != nil {
http.Error(w, "创建文件失败", http.StatusInternalServerError)
return
}
defer f.Close()
// 将上传的文件内容拷贝到本地文件
_, err = io.Copy(f, file)
if err != nil {
http.Error(w, "保存文件失败", http.StatusInternalServerError)
return
}
fmt.Fprintf(w, "文件 %s 上传成功，大小: %d bytes", handler.Filename, handler.Size)
}
2. 注册路由并启动服务
func main() {http.HandleFunc("/upload", uploadHandler)
http.Handle("/", http.FileServer(http.Dir("."))) // 提供静态页面
fmt.Println("服务器启动，监听 :8080")
log.Fatal(http.ListenAndServe(":8080", nil))
}
3. 编写前端HTML表单
处理多个文件与表单字段
如果需要同时接收多个文件或多个文本字段，可以通过 r.MultipartForm 访问所有部分：
// 解析后，r.MultipartForm 包含所有数据form := r.MultipartForm
// 获取所有文件
files := form.File["files"] // 假设前端 name="files"
for _, fh := range files {
file, _ := fh.Open()
defer file.Close()
dst, _ := os.Create("./uploads/" + fh.Filename)
defer dst.Close()
io.Copy(dst, file)
}
// 获取文本字段
names := form.Value["username"]
if len(names) > 0 {
fmt.Println("用户名:", names[0])
}
安全与最佳实践
在生产环境中，需注意以下几点：
- 限制文件大小：通过 ParseMultipartForm(maxMemory) 控制内存使用，防止OOM
- 验证文件类型：不要只依赖客户端的 Content-Type，应检查文件头（magic number）
- 重命名文件：避免路径遍历攻击，使用随机文件名如 UUID
- 限制扩展名：只允许特定类型（如 .jpg, .png）
- 设置超时：为上传请求设置合理的读写超时
基本上就这些。Golang的multipart支持简洁高效，结合标准库即可快速实现安全可靠的文件上传功能。关键在于正确使用 ParseMultipartForm、FormFile 和 io.Copy，同时做好输入校验与资源管理。
