应手动构造 multipart/form-data 请求体：用 multipart.writer 边读边写文件流，显式设置 content-type、字段顺序和超时，避免内存溢出与解析失败。
用 http.PostFile 上传单个文件？别这么干
这个函数看着方便，但底层直接读整个文件进内存，大文件（比如 >50MB）会触发 OOM 或被服务器拒绝。它也不支持自定义 Content-Type、添加额外字段、设置超时——实际项目里基本不用。
正确做法是手动构造 multipart/form-data 请求体：
- 用
multipart.Writer创建写入器，显式控制边界（boundary）和字段顺序 - 先写普通字段（如
user_id），再写文件字段（file），顺序错可能导致后端解析失败 - 文件流必须用
io.Copy边读边写，避免一次性加载到内存
怎么写一个安全可用的 multipart 文件上传函数
核心是封装好 multipart.Writer + http.Client 的组合，关键参数不能硬编码：
-
boundary让multipart.NewWriter自动生成，别手写（容易含非法字符） - 文件字段名（如
avatar）必须和后端约定一致，大小写、下划线都敏感 - 务必设置
req.Header.Set("Content-Type", w.FormDataContentType())，否则后端收不到 multipart 数据 - 用
context.WithTimeout控制整个请求生命周期，防止卡死
示例片段：
w := multipart.NewWriter(&buf)
_ = w.WriteField("user_id", "123")
fw, _ := w.CreateFormFile("avatar", "photo.jpg")
io.Copy(fw, file)
w.Close()
req, _ := http.NewRequest("POST", url, &buf)
req.Header.Set("Content-Type", w.FormDataContentType())
上传多个文件或混传字段时字段顺序和命名陷阱
后端框架（如 Gin、Echo、Spring）对字段顺序通常不敏感，但对重复字段名的处理差异很大。比如同时传 files 和 files[]，PHP 可能只认后者，Go 后端可能全收但类型不一致。
- 多个同名文件字段（如
files）需调用多次w.CreateFormFile，不是一次传切片 - 避免用
[]后缀命名字段（如images[]），Go 标准库不自动识别数组语义，得靠后端解析逻辑支持 - 如果要传 JSON 元数据，别塞进文件字段，用单独的
w.WriteField发字符串，再在服务端json.Unmarshal
调试时看不到请求体？用 httputil.DumpRequestOut 抓原始流量
开发阶段最常踩的坑是：代码没报错，但后端收不到文件。原因往往是 Content-Type 没设对、字段名拼错、或者文件指针已到 EOF（os.Open 后没 Seek(0,0)）。
- 不要依赖日志打印
req.Body—— 它是一次性可读流，dump 前会消耗掉 - 用
httputil.DumpRequestOut(req, true)获取完整 HTTP 报文（含 headers + body 原始字节） - 注意 dump 出来的 body 是已编码的 multipart 内容，检查是否有
Content-Disposition: form-data; name="avatar"; filename="x.jpg"这类行
真正难的从来不是写几行上传代码，而是确认你发出去的每一个字节，都刚好落在后端解析器的预期路径上。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
