go 的 http.fileserver 不能处理文件上传，因其仅响应 get 请求，而上传需 post 和 multipart/form-data 解析；安全接收单个文件须三步：设内存限制、解析表单、校验后保存。
Go 的 http.FileServer 不能直接处理文件上传，必须手动解析 multipart/form-data 请求体 —— 这是绝大多数初学者卡住的第一步。
为什么 http.ServeFile 和 http.FileServer 对上传无效
这两个函数只响应 GET 请求，用于静态文件下发；而文件上传是 POST 请求，且携带的是二进制分段数据（multipart/form-data），需要显式调用 req.ParseMultipartForm() 解析。
-
http.ServeFile会忽略请求体，直接返回文件内容，对上传表单完全无响应 - 直接把上传请求路由到
http.FileServer会返回 405 Method Not Allowed 或空响应 - 不调用
ParseMultipartForm就读不到req.MultipartForm，req.FormFile会返回nil, http.ErrNotMultipart
如何安全接收并保存单个文件（含校验）
核心是三步：设置内存限制 → 解析表单 → 逐项校验后保存。漏掉任何一步都可能引发内存溢出、路径遍历或空文件写入。
- 调用
req.ParseMultipartForm(32 限制最大内存缓存为 32MB，超限会自动写入临时磁盘文件 - 用
req.FormFile("file")获取*multipart.FileHeader，注意字段名必须和 HTML 表单的name="file"一致 - 检查
header.Size是否为 0（空上传）、header.Filename是否为空（无文件选中） - 用
filepath.Join拼接保存路径，再用filepath.Clean过滤../路径穿越，避免写入系统目录 - 打开目标文件时使用
os.O_CREATE | os.O_WRONLY | os.O_TRUNC，确保覆盖而非追加
func uploadHandler(w http.ResponseWriter, r *http.Request) {
if r.Method != "POST" {
http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
return
}
if err := r.ParseMultipartForm(32 << 20); err != nil {
http.Error(w, "Unable to parse form", http.StatusBadRequest)
return
}
file, header, err := r.FormFile("file")
if err != nil {
http.Error(w, "No file received", http.StatusBadRequest)
return
}
defer file.Close()
if header.Size == 0 {
http.Error(w, "Empty file", http.StatusBadRequest)
return
}
safeName := filepath.Base(header.Filename)
dst, _ := os.OpenFile(filepath.Join("./uploads", safeName), os.O_CREATE|os.O_WRONLY|os.O_TRUNC, 0644)
defer dst.Close()
io.Copy(dst, file)
}
并发上传与临时文件清理的坑
Go 默认复用 multipart.Form 的临时文件句柄，若不显式清理，大量上传会导致 too many open files 错误，尤其在高并发场景下。
立即学习“go语言免费学习笔记（深入）”；
-
r.MultipartForm在解析后会缓存所有文件句柄，即使你只读取了其中一个 - 必须在 handler 结束前调用
r.MultipartForm.RemoveAll()，否则临时文件不会被删除 - 如果 handler 中 panic，
RemoveAll()不会被执行 —— 建议用defer r.MultipartForm.RemoveAll()放在ParseMultipartForm之后 - 生产环境应设置
http.Server.ReadTimeout和WriteTimeout，防止慢上传耗尽连接
前端表单与后端字段名必须严格匹配
浏览器发送的 multipart 数据依赖字段名定位文件，名字错一个字符或大小写不符，FormFile 就返回 nil。
- HTML 表单必须设
enctype="multipart/form-data"，缺了这个属性，文件内容根本不会编码进请求体 -
<input type="file" name="avatar">对应后端r.FormFile("avatar")，不是"file"或"File" - 如需多文件，用
<input type="file" name="files" multiple>，后端改用r.MultipartForm.File["files"]遍历切片 - Chrome/Firefox 对空文件上传行为不一致：有的发空
filename=""，有的干脆不包含该字段 —— 后端必须同时检查err和header.Filename
真正麻烦的不是写上传逻辑，而是边界情况：超大文件触发磁盘写入但没配好临时目录权限、用户上传 ../../../etc/passwd 这种文件名、并发时临时文件堆积。这些点不提前压测，上线后就只能看监控等报警。
