如何在 Go 中实现 HTTP Multipart 响应（多段下载）-Golang-PHP中文网

go标准库不支持直接构造http multipart/mixed响应，因responsewriter仅允许一次header提交，无法分段写入boundary和子part；正确做法是用mime/multipart.writer写入bytes.buffer后一次性输出。

如何在 go 中实现 http multipart 响应（多段下载）

Go 标准库不支持直接构造 HTTP multipart/mixed 响应（即服务端主动分段返回多个 body 部分），net/http 的 ResponseWriter 仅允许写入一次状态码和 header，无法多次调用 Write 来拼接 multipart boundary 和子部分 —— 这是核心限制，不是写法问题。

为什么 `http.ResponseWriter` 不能用于 multipart 响应

HTTP multipart 响应（如 multipart/mixed 或 multipart/byteranges）要求响应体由多个子部分（part）组成，每个 part 以 --boundary 开头，并携带自己的 Content-Type、Content-Length 等 header。而 ResponseWriter 在第一次调用 Write 后即隐式提交状态行和 header，后续写入只能追加到 body 流中，无法再插入新的 header 行或 boundary 分隔符。

常见错误现象：

手动写 --boundary 和子 part header，但浏览器/客户端收到的是纯文本或解析失败（MIME parse error）
用 io.MultiWriter 或自定义 io.Writer 尝试“拦截”写入，仍无法控制 header 发送时机
误以为 http.DetectContentType 或 mime/multipart 包能反向生成响应 —— 它们只用于解析请求端的 multipart 数据

替代方案：用 `io.Pipe` 手动构造完整响应流

唯一可行路径是绕过 ResponseWriter.Write 的自动 header 提交机制，改用 io.Pipe 构建一个可分段写入的字节流，再通过 ResponseWriter 的底层 Hijacker 或直接操作 http.Flusher（需配合 bufio.Writer）来发送。但更稳妥的做法是：提前生成完整 multipart body，再一次性写入。

实操建议：

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

使用 mime/multipart.Writer 创建内存 buffer（bytes.Buffer），调用 w.WriteField 或 w.CreatePart 写入各段内容
设置响应 header：w.Header().Set("Content-Type", "multipart/mixed; boundary="+w.Boundary())（注意：必须在写入 body 前设置）
最后调用 w.WriteTo(w.Header().Get("Content-Type")) 不成立 —— 正确做法是 buf.Bytes() 获取完整字节，再 write.Write(buf.Bytes())
若内容较大（如多张图片），避免全量加载进内存，改用 io.Pipe + goroutine 边生成边写，但需确保 Content-Length 可预估或设为 Transfer-Encoding: chunked

示例关键片段：

func handler(w http.ResponseWriter, r *http.Request) {
	buf := &bytes.Buffer{}
	mw := multipart.NewWriter(buf)
	w.Header().Set("Content-Type", "multipart/mixed; boundary="+mw.Boundary())

	// 第一段：JSON 元信息
	part, _ := mw.CreatePart(map[string][]string{"Content-Type": {"application/json"}})
	json.NewEncoder(part).Encode(map[string]string{"status": "ok"})

	// 第二段：PNG 图片
	part, _ = mw.CreatePart(map[string][]string{"Content-Type": {"image/png"}})
	io.Copy(part, pngFile)

	mw.Close() // 必须调用，否则 boundary 结尾不完整
	w.Write(buf.Bytes())
}

更现实的场景：用 `multipart/form-data` 请求响应？

如果你实际想实现的是“服务端返回多个文件供前端下载”，那 multipart/mixed 并非标准做法。浏览器不原生支持解析 multipart 响应并触发多文件下载；用户点击链接只会下载一个 .bin 文件。

真正可用的替代方案：

返回 ZIP 包（application/zip），用 archive/zip 动态打包多个文件
返回 JSON 列表，前端逐个发起 fetch() 下载（配合 Content-Disposition: attachment）
用 Content-Range + 206 Partial Content 实现单个大文件的分片传输 —— 这是标准 HTTP Range 请求，不是 multipart
若必须用 multipart，只建议用于内部服务间通信（如微服务 A 返回多类型数据给服务 B），且接收方明确用 mime/multipart.Reader 解析