Go multipart 怎么同时上传文件和重复字段

Go 的 multipart/form-data 不要求一个字段名只能出现一次。客户端把文件作为一个 part 写入，再连续写入多个同名普通字段即可；服务端解析后，重复字段会进入 Form.Value[field]，文件会进入 Form.File[field]。关键是不要用单值读取方式覆盖前面的值，也不要手写 Content-Type 的 boundary。

客户端：一个文件加两个重复字段

下面的请求体同时发送 attachments=readme.txt、tag=go 和 tag=http。FormDataContentType 会把 writer 当前 boundary 放进请求头，避免服务端找不到分隔线。

package main

import (
    "bytes"
    "fmt"
    "io"
    "mime/multipart"
    "net/http"
    "strings"
)

func main() {
    var body bytes.Buffer
    writer := multipart.NewWriter(&body)

    // 文件 part 使用文件字段名和文件名，示例内容来自内存。
    filePart, err := writer.CreateFormFile("attachments", "readme.txt")
    if err != nil { panic(err) }
    if _, err = io.Copy(filePart, strings.NewReader("multipart demo\n")); err != nil { panic(err) }

    // 同一个字段名可以写入多次，服务端会按出现顺序保留两个值。
    for _, tag := range []string{"go", "http"} {
        if err = writer.WriteField("tag", tag); err != nil { panic(err) }
    }
    // Close 写入结尾 boundary；遗漏它时服务端可能把请求判为不完整。
    if err = writer.Close(); err != nil { panic(err) }

    req, err := http.NewRequest(http.MethodPost, "https://api.example.test/upload", &body)
    if err != nil { panic(err) }
    req.Header.Set("Content-Type", writer.FormDataContentType())
    fmt.Println(req.Header.Get("Content-Type"))
}

服务端：用切片读取重复值和文件

服务端先调用 ParseMultipartForm，再通过完整字段名访问切片。Value.Get 只适合只关心一个值的场景；需要保留全部重复字段时，应读取 map 中的 []string。

func upload(w http.ResponseWriter, r *http.Request) {
    // 这里的 8 MiB 是内存阈值，较大的文件可能落到临时文件。
    if err := r.ParseMultipartForm(8 

字段名和大小边界怎么排查

如果字段切片为空，先确认客户端写入的字段名与服务端读取键完全一致；文件 part 还必须带文件名，否则它可能按普通字段处理。请求头应来自 FormDataContentType，不要把 boundary 截断后手写。

ReadForm 会把一部分数据放入内存，超出阈值的文件可以落盘；标准库还限制 part 数和 header 数。大量小字段触发 multipart: message too large 时，优先限制客户端字段数量和单请求大小，再评估 GODEBUG=multipartmaxparts、multipartmaxheaders 等边界配置，而不是无限放大服务端上限。

常见问题

重复字段能不能用同一个 key 发送？

可以。每次调用 WriteField 都会追加一个 part，服务端从 Value[key] 读取全部字符串。

为什么服务端解析不到文件？

检查是否调用了 writer.Close()，请求头是否使用同一个 writer 的 FormDataContentType，以及文件字段名是否和 Form.File 的键一致。

关闭文件后还需要 RemoveAll 吗？

需要。关闭句柄只结束当前读取；RemoveAll 负责删除解析阶段生成的临时文件。

这套写法的边界很明确：文件用 File 切片处理，重复文本用 Value 切片处理，boundary 交给 writer 管理。把三处对应关系保持一致，文件和重复字段就能在一次请求中稳定传递。