Golang通过net/http和multipart包处理多文件上传:前端用multiple属性表单提交,后端调用ParseMultipartForm解析并用MultipartForm.File获取同名文件列表。

在Golang中处理多文件上传并不复杂,主要依赖标准库中的 net/http 和 multipart 包。通过解析HTTP请求中的 multipart/form-data 数据,可以提取多个上传的文件并进行保存或处理。
1. 前端HTML表单支持多文件上传
要实现多文件上传,前端需要提供一个支持 multiple 属性的文件输入框:
注意:name="files" 会被后端用于获取文件列表,multiple 表示允许多选。
2. 后端接收并解析多个文件
Golang服务端使用 r.ParseMultipartForm() 解析请求,再通过 r.MultipartForm.File 获取同名文件列表。
立即学习“go语言免费学习笔记(深入)”;
示例代码:
import (
"fmt"
"io"
"net/http"
"os"
"path"
)
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, err.Error(), http.StatusBadRequest)
return
}
files := r.MultipartForm.File["files"]
for _, fileHeader := range files {
file, err := fileHeader.Open()
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
continue
}
defer file.Close()
// 创建保存文件
out, err := os.Create("./uploads/" + fileHeader.Filename)
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
continue
}
defer out.Close()
// 拷贝内容
_, err = io.Copy(out, file)
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
continue
}
fmt.Fprintf(w, "成功上传: %s\n", fileHeader.Filename)
}
}
func main() {
http.HandleFunc("/upload", uploadHandler)
http.Handle("/", http.FileServer(http.Dir("."))) // 提供HTML页面
fmt.Println("服务启动在 :8080")
http.ListenAndServe(":8080", nil)
}
3. 安全与优化建议
实际项目中需考虑以下几点:
- 验证文件类型:检查 MIME 类型或文件头,防止恶意文件上传
- 限制文件大小:在 ParseMultipartForm 中设置合理上限
- 重命名文件:避免覆盖或路径穿越攻击,如使用 UUID 或时间戳重命名
- 创建上传目录:确保 ./uploads 目录存在且有写权限
- 防重复文件名:多个同名文件应做区分处理
4. 使用第三方库简化操作(可选)
如果需要更强大的功能,可以使用如 gorilla/mux 或 gin 框架:
// 使用 Gin 框架示例func uploadHandler(c *gin.Context) {
form, _ := c.MultipartForm()
files := form.File["files"]
for _, file := range files {
c.SaveUploadedFile(file, "./uploads/"+file.Filename)
}
c.String(http.StatusOK, "共上传 %d 个文件", len(files))
}
框架封装了常见逻辑,代码更简洁。
基本上就这些。只要理解 multipart 请求结构,Golang 多文件上传实现起来很直接。关键是正确解析、安全保存、妥善处理错误。不复杂但容易忽略细节。










