Go mime.ParseMediaType 解析带引号参数时怎样取出真实值

遇到 Content-Type: multipart/form-data; boundary="----demo;part" 这类值时，不要自己按分号切字符串。Go 的 mime.ParseMediaType 会按照 MIME 规则拆出媒体类型和参数，并把带引号的参数还原成可以直接使用的值。

官方地址：https://pkg.go.dev/mime#ParseMediaType

最稳妥的处理方式是：先检查返回的 error，再读取参数 map；参数名会被规范化为小写，参数值则保留原始大小写。参数中的引号、空格和转义字符由解析器处理，不要再次手工去引号。

先看 ParseMediaType 返回什么

这个函数返回三个值：媒体类型、参数 map 和 error。成功时媒体类型会被转换成小写并去掉首尾空白，参数名也会以小写形式出现在 map 中，但参数值的大小写会保留。

package main

import (
    "fmt"
    "mime"
)

func main() {
    // 让解析器负责处理分号、引号和参数空白，不手写字符串切分。
    value := `Text/HTML; Charset="UTF-8"; profile="compact"`
    mediaType, params, err := mime.ParseMediaType(value)
    if err != nil {
        // 参数格式错误时不要继续使用不完整的 params。
        fmt.Println("解析失败:", err)
        return
    }

    fmt.Println("媒体类型:", mediaType)
    fmt.Println("字符集:", params["charset"])
    fmt.Println("profile:", params["profile"])
}

带引号的值会怎样还原

参数值放在双引号中时，引号只是 MIME 语法的一部分，不会出现在返回值里。例如 boundary="----demo;part" 的值是 ----demo;part，中间的分号也不会被误认为新的参数分隔符。

下面的例子故意放入空格、分号和反斜杠，重点是观察返回值，而不是自己实现一个 MIME 词法分析器。

package main

import (
    "fmt"
    "mime"
)

func main() {
    // 引号内部的分号属于参数值，不能用 strings.Split(value, ";") 代替解析。
    header := `multipart/form-data; boundary="----go;part\\v2"; note="A file"`
    _, params, err := mime.ParseMediaType(header)
    if err != nil {
        fmt.Println("参数格式错误:", err)
        return
    }

    // 解析器已经移除语法引号，业务代码直接使用 map 中的值。
    fmt.Printf("boundary=%q\n", params["boundary"])
    fmt.Printf("note=%q\n", params["note"])
}

手工按分号切分会把 boundary 截断，也可能把引号残留在业务值中。只有在已经完成 MIME 解析之后，业务层才应该处理参数语义。

参数名小写，参数值保留大小写

读取参数时统一使用小写参数名，例如 params["charset"]，不要依赖输入头里写的是 Charset 还是 charset。这是解析结果的规范化行为。

func readCharset(header string) (string, error) {
    // ParseMediaType 负责规范化参数名并解析引号。
    _, params, err := mime.ParseMediaType(header)
    if err != nil {
        return "", fmt.Errorf("解析 Content-Type 失败: %w", err)
    }

    // 参数缺失不是语法错误，按业务需要决定默认值。
    charset, ok := params["charset"]
    if !ok {
        return "utf-8", nil
    }
    return charset, nil
}

注意，参数名的小写化不等于参数值也会变成小写。比如值是 UTF-8，业务层是否把它转换成小写，应由字符集匹配规则决定。

错误时如何保留诊断信息

如果可选参数语法不完整，函数可能同时返回媒体类型和错误。不要只判断媒体类型非空就继续取参数；正确做法是先处理 err。这样可以避免把一个看似识别成功、实际参数已经损坏的请求交给后续逻辑。

func parseContentType(header string) (string, map[string]string, error) {
    // 返回包装后的错误，让上层日志保留原始解析原因。
    mediaType, params, err := mime.ParseMediaType(header)
    if err != nil {
        return "", nil, fmt.Errorf("Content-Type 参数无效: %w", err)
    }

    // 业务只接受需要的媒体类型，避免把任意头部交给 multipart 处理。
    if mediaType != "multipart/form-data" {
        return "", nil, fmt.Errorf("不支持的媒体类型: %s", mediaType)
    }
    return mediaType, params, nil
}

不要用 strings.Split 替代 MIME 解析

常见的简化写法是先按 ; 分割，再按 = 分割。这种写法只能处理非常理想的输入，一旦参数值带引号、转义字符或额外空白，就会把语法符号误当成数据边界。

如果后续要读取 multipart 内容，可以把解析出的 boundary 交给专门的 multipart API；本文只负责解析媒体类型头部，不把头部解析和文件内容扫描混在一起。

小结

相关问题

为什么 boundary 中的分号不会被拆成两个参数？

因为它位于引号包围的参数值中，ParseMediaType 按 MIME 语法识别整段值，业务代码不需要自行分隔。

参数名可以用大写读取吗？

不建议。函数返回的参数名会规范化为小写，统一使用小写键最稳定。

解析成功后还需要检查参数是否存在吗？

需要。语法正确不代表每个业务参数都存在，缺少 boundary 或 charset 时应由业务层给出默认值或返回明确错误。