Go multipart.Reader NextRawPart 怎么保留原始传输编码

如果 multipart 部件带有 Content-Transfer-Encoding: quoted-printable，又需要保存它在传输中的原样字节，应该调用 Reader.NextRawPart。它会保留这个头字段，读取部件 body 时也不会替你做 quoted-printable 解码；Reader.NextPart 则会隐藏该头并透明解码。

官方文档：https://pkg.go.dev/mime/multipart

审计、转发、验签或落盘时先用 NextRawPart 保留原始部件；只有业务真正需要文本内容时，再在应用层显式解码。

这里的“原始”指 MIME 部件层的传输内容，不是把整个 HTTP 请求的边界线也交给调用方。multipart.Reader 仍然负责识别 boundary，调用方拿到的是当前部件的头和 body 字节。

NextPart 和 NextRawPart 到底差在哪里

两者都返回 *multipart.Part，也都以 io.EOF 表示没有更多部件。真正不同的是 Content-Transfer-Encoding 为 quoted-printable 时的读取语义：

例如传输内容中的 name=3Dgo，用 NextRawPart 读取时仍会得到这组字节；后续如果确认它是 quoted-printable 文本，再显式解码才会得到 name=go。NextRawPart 不会替你识别或解码其他自定义编码。

先从 Content-Type 安全取出 boundary

不要用字符串截取硬拆 Content-Type。boundary 可能带引号，也可能和其他参数一起出现，使用 mime.ParseMediaType 能把媒体类型与参数分开：

package main

import (
    "fmt"
    "io"
    "mime"
    "mime/multipart"
    "strings"
)

func readRawParts(contentType, body string) error {
    // 由标准库解析媒体类型，避免手工截取带引号的 boundary。
    mediaType, params, err := mime.ParseMediaType(contentType)
    if err != nil {
        return fmt.Errorf("解析 Content-Type 失败: %w", err)
    }
    if !strings.HasPrefix(mediaType, "multipart/") {
        return fmt.Errorf("不是 multipart 媒体类型: %s", mediaType)
    }
    boundary := params["boundary"]
    if boundary == "" {
        return fmt.Errorf("缺少 multipart boundary")
    }

    // Reader 只负责按 boundary 切分部件，body 可来自 HTTP 请求流。
    mr := multipart.NewReader(strings.NewReader(body), boundary)
    for {
        // Raw 版本保留传输编码头和原始 body 字节。
        part, err := mr.NextRawPart()
        if err == io.EOF {
            return nil
        }
        if err != nil {
            return fmt.Errorf("读取 multipart 部件失败: %w", err)
        }

        raw, err := io.ReadAll(part)
        if err != nil {
            return fmt.Errorf("读取部件 %q 失败: %w", part.FormName(), err)
        }
        fmt.Printf("name=%q encoding=%q raw=%q\\n",
            part.FormName(), part.Header.Get("Content-Transfer-Encoding"), raw)
    }
}

示例中的 body 只是为了展示读取链路；生产环境可把 HTTP 请求体直接传给 multipart.NewReader。调用 NextRawPart 后，先读 part.Header，再读取 body，便能把编码信息和原始内容一起保存。

用 NextRawPart 保存原始部件

如果目标是原样转发或留档，应该边读边写，避免为了检查一个部件把整个 multipart 请求一次性放进内存。下面把部件 body 写入目标文件；真实项目中还应根据文件大小、请求超时和磁盘配额设置限制。

func saveRawPart(part *multipart.Part, dst io.Writer) error {
    // Header 与 body 分开保存，便于后续审计传输编码声明。
    if _, err := io.WriteString(dst, "Content-Transfer-Encoding: "+part.Header.Get("Content-Transfer-Encoding")+"\\n"); err != nil {
        return fmt.Errorf("保存部件头失败: %w", err)
    }

    // Copy 只搬运当前部件内容，不主动做 quoted-printable 解码。
    if _, err := io.Copy(dst, part); err != nil {
        return fmt.Errorf("保存部件原始 body 失败: %w", err)
    }
    return nil
}

Part 是顺序读取对象，调用下一次 NextRawPart 时，前一个部件会被关闭并推进到下一个边界。因此不要把当前 Part 留到循环外异步读取；如果需要异步处理，先复制到受控缓冲区或文件，再交给其他 goroutine。

需要文本内容时再显式解码

NextRawPart 只负责保留传输表示，不代表应用永远不应解码。确认头字段是 quoted-printable 后，可以把当前部件包一层解码器；但要注意，解码器会消费输入，原始副本应在此之前写入文件或缓冲区。

import "mime/quotedprintable"

func decodeQuotedPrintable(part *multipart.Part) ([]byte, error) {
    // 只对明确声明的 quoted-printable 调用解码器，避免误处理二进制部件。
    if !strings.EqualFold(part.Header.Get("Content-Transfer-Encoding"), "quoted-printable") {
        return io.ReadAll(part)
    }
    decoded := quotedprintable.NewReader(part)
    // 解码后的结果用于业务文本，不再等同于原始传输字节。
    return io.ReadAll(decoded)
}

常见误区有三个：把 NextRawPart 当成“完全不解析 MIME”的接口；在同一个 reader 上交替调用 NextPart 和 NextRawPart；以及保存原始 body 后又把解码结果覆盖回原文件。只要先决定数据用途，再选择读取路径，这些问题都能避免。

常见问题

NextRawPart 会保留 multipart 的 boundary 吗？不会。boundary 仍由 Reader 用来切分部件，返回的 Part body 不包含外层分隔线。

普通 HTTP 表单是否必须使用 NextRawPart？不必须。只取字段值时 ReadForm 或 NextPart 更直接；只有验签、转发、审计或需要保留传输表示时，才有必要选择 Raw 版本。

为什么 Header 里看不到 quoted-printable？如果使用的是 NextPart，这正是标准库的特殊处理；改用 NextRawPart 才能观察到该字段。