Go语言通过net/http和mime/multipart处理multipart/form-data格式的文件上传，调用r.ParseMultipartForm(32
在 Go 语言中处理 HTTP 文件上传，通常使用 multipart/form-data 编码格式。这种格式支持同时上传文件和表单字段。Golang 的标准库 net/http 和 mime/multipart 提供了完整的支持，无需引入第三方库即可实现文件接收与解析。
启用 Multipart Form 处理
当客户端通过 POST 请求上传文件时，请求头中的 Content-Type 会包含 multipart/form-data 及 boundary 标识。Go 的 http.Request.ParseMultipartForm 方法会自动解析这类请求。
基本用法如下：
func uploadHandler(w http.ResponseWriter, r *http.Request) {
// 解析 multipart 表单，maxMemory 控制内存中缓存的最大字节数
err := r.ParseMultipartForm(32 << 20) // 32MB
if err != nil {
http.Error(w, err.Error(), http.StatusBadRequest)
return
}
// 获取上传的文件，file 是 input 的 name 属性
file, handler, err := r.FormFile("file")
if err != nil {
http.Error(w, "获取文件失败", http.StatusBadRequest)
return
}
defer file.Close()
// 创建本地文件用于保存
dst, err := os.Create("./uploads/" + handler.Filename)
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)
}
处理多个文件和表单字段
实际应用中，一个表单可能包含多个文件或普通文本字段（如用户 ID、描述等）。可以通过 r.MultipartForm 访问所有字段。
立即学习“go语言免费学习笔记（深入）”；
示例：同时接收文件和文本字段
err := r.ParseMultipartForm(32 << 20)
if err != nil {
http.Error(w, err.Error(), http.StatusBadRequest)
return
}
// 获取文本字段
userName := r.FormValue("user_name")
userId := r.FormValue("user_id")
// 获取多个文件（input name="files" 支持 multiple）
files := r.MultipartForm.File["files"]
for _, f := range files {
src, err := f.Open()
if err != nil {
continue
}
defer src.Close()
dst, err := os.Create("./uploads/" + f.Filename)
if err != nil {
continue
}
defer dst.Close()
io.Copy(dst, src)
}
fmt.Fprintf(w, "用户 %s (ID: %s) 上传了 %d 个文件", userName, userId, len(files))
手动解析 Multipart 以精细控制
若需更灵活地处理流式数据或大文件，可直接使用 multipart.NewReader 手动解析请求体。
这种方法适合避免将整个表单加载进内存的场景。
func streamUploadHandler(w http.ResponseWriter, r *http.Request) {
if r.Header.Get("Content-Type") == "" {
http.Error(w, "缺少 Content-Type", http.StatusBadRequest)
return
}
reader, err := r.MultipartReader()
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
for {
part, err := reader.NextPart()
if err == io.EOF {
break
}
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
// 判断是否为文件字段（非表单字段）
if part.FileName() == "" {
continue // 非文件，跳过或读取文本
}
outFile, err := os.Create("./uploads/" + part.FileName())
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
_, err = io.Copy(outFile, part)
outFile.Close()
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
}
fmt.Fprint(w, "流式上传完成")
}
安全与性能建议
在生产环境中处理文件上传时，需注意以下几点：
- 限制文件大小：通过 ParseMultipartForm 的参数控制最大内存使用，防止 OOM
- 验证文件类型：不要仅依赖扩展名，应检查 MIME 类型或文件头（magic number）
- 重命名上传文件：避免路径遍历攻击，使用 UUID 或时间戳命名
- 设置超时：为上传接口配置合理的读写超时
- 限制并发：对高负载服务，考虑使用限流机制
