Go mime.ParseMediaType 怎样读取 Content-Type 参数

处理 HTTP 头时，Content-Type 往往不只是一个媒体类型：text/html; charset=utf-8 还带着参数，multipart/form-data 通常还需要读取 boundary。我的经验是不要用 strings.Split 手工按分号拆分，直接交给 mime.ParseMediaType 更稳妥。它会返回规范化后的媒体类型、参数 map 和解析错误。

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

ParseMediaType 先把一行 MIME 文本拆成三部分

mime.ParseMediaType 的签名是 func ParseMediaType(v string) (mediatype string, params map[string]string, err error)。它适用于 Content-Type 和 Content-Disposition 这类 MIME 值：第一返回值是媒体类型，第二返回值保存可选参数，第三返回值说明输入是否按规则解析成功。

例如输入 Text/HTML ; Charset=utf-8 ，成功后媒体类型会变成 text/html，参数名可以用 params["charset"] 读取。参数名大小写不应该成为业务分支条件，参数值则保持文档中解析出的值。

读取 charset、boundary 时先判断 error

最常见的写法是先解析，再读取自己真正关心的参数。下面的函数只提取字符集；没有 charset 不等于解析失败，调用方可以把空值交给后续默认策略，但不能忽略解析错误。

package main

import (
	"fmt"
	"mime"
)

func readCharset(value string) (string, error) {
	// ParseMediaType 会处理参数分隔符和引号，不要先用 strings.Split 拆文本。
	mediatype, params, err := mime.ParseMediaType(value)
	if err != nil {
		// 解析失败时不把可能存在的部分结果当成可靠输入。
		return "", fmt.Errorf("parse content type %q: %w", value, err)
	}
	if mediatype != "text/html" {
		// 媒体类型是业务判断条件，参数 map 不能代替它。
		return "", fmt.Errorf("unexpected media type: %s", mediatype)
	}
	charset := params["charset"]
	if charset == "" {
		// 没有 charset 是合法的“参数缺失”，由上层决定默认值。
		return "", nil
	}
	return charset, nil
}

func main() {
	// 示例输入包含媒体类型和一个可选参数。
	charset, err := readCharset("text/html; charset=utf-8")
	if err != nil {
		fmt.Println("parse failed:", err)
		return
	}
	fmt.Println("charset:", charset)
}

这里把“没有参数”和“解析失败”分开处理：前者是业务策略问题，后者是输入格式问题。对于 multipart/form-data，同样的模式可以读取 params["boundary"]，但真正创建 multipart reader 前仍要确认媒体类型就是 multipart 类型且 boundary 非空。

带引号的参数不要自己按分号切

参数值可能被引号包住，值里还可能出现需要转义的字符。手写 strings.Split(value, ";") 看起来简单，却会把参数值内部的分号误当成新的参数边界。ParseMediaType 会按 MIME 语法处理这层细节，调用方只需要读取解析后的 map。

func readBoundary(value string) (string, error) {
	// 引号和参数转义交给 mime 包，避免手写分号解析器遗漏边界。
	mediatype, params, err := mime.ParseMediaType(value)
	if err != nil {
		return "", err
	}
	if mediatype != "multipart/form-data" {
		return "", fmt.Errorf("not multipart form data: %s", mediatype)
	}
	boundary, ok := params["boundary"]
	if !ok || boundary == "" {
		// boundary 缺失时不能继续构造 multipart.Reader。
		return "", fmt.Errorf("multipart boundary is missing")
	}
	return boundary, nil
}

ok 可以帮助区分“键不存在”和“键存在但值为空”，虽然两种情况在这个业务里都不能继续。更重要的是，参数键使用小写形式读取；不要根据原始头部里写成 Boundary 还是 boundary 来写分支。

解析错误、参数缺失和业务不支持不是一回事

我在接口处理里通常把结果分成三层。第一层是 MIME 文本能否解析；第二层是解析后的媒体类型和参数是否满足当前接口；第三层才是读取内容或创建下游对象。这样可以避免把一个格式错误误报成“没有 charset”，也不会因为参数存在就接受不支持的媒体类型。

把解析放在 HTTP 业务入口的第一道边界

如果输入来自请求头，解析函数的职责是把字符串变成结构化结果，不是替接口决定所有默认值。可以在入口处完成解析，再把明确的数据传给上传、渲染或内容协商逻辑：

func acceptContentType(header string) (string, map[string]string, error) {
	// 先完成语法解析，再把业务允许的类型交给调用者判断。
	mediatype, params, err := mime.ParseMediaType(header)
	if err != nil {
		return "", nil, err
	}
	if mediatype == "" {
		// 空媒体类型不应进入后续内容处理。
		return "", nil, fmt.Errorf("empty media type")
	}
	return mediatype, params, nil
}

这个封装没有把所有未知媒体类型都改写成某个默认值，原因是默认值属于具体接口的协议约定。解析器只负责稳定地拆解输入，业务层负责决定“支持什么”和“缺参数时怎么办”。

常见问题

为什么不直接用 strings.Split 解析 Content-Type？

因为参数可能带引号和转义，简单按分号拆分会破坏参数值。MIME 解析器已经处理了这些语法边界，业务代码只读取返回的 map。

params["charset"] 为空是不是一定解析失败？

不是。只要 err == nil，它可能只是没有 charset 参数。是否允许缺失要由具体协议决定。

ParseMediaType 出错时还能使用 mediatype 吗？

官方文档说明可选参数解析出错时可能仍返回媒体类型，但业务代码应把 err 作为失败信号处理，避免使用不完整的参数结果。

参数名要不要先转小写？

不需要。返回的参数键已经按小写形式提供，直接使用小写键查询即可。