Go mime.ParseMediaType 为什么参数键会转成小写

我在处理一批带自定义 Content-Type 的请求时，最容易误判的不是 MIME 语法，而是参数键的大小写。Go 的 mime.ParseMediaType 会把媒体类型和参数名规范化为小写，但参数值保留原样。因此 Charset 应该用 params["charset"] 读取，而不是继续寻找 params["Charset"]。

ParseMediaType 返回值为什么分成三层

函数签名是 mime.ParseMediaType(v string) (mediatype string, params map[string]string, err error)。第一项是媒体类型，第二项是参数 map，第三项表示整个值是否符合解析规则。比如输入中写成大写的 Text/HTML; Charset=UTF-8; Boundary=PartA，读取时应按下面的方式处理：

package main

import (
    "fmt"
    "mime"
)

func main() {
    // 参数名会规范化为小写，参数值 UTF-8 和 PartA 保持原样。
    mediaType, params, err := mime.ParseMediaType("Text/HTML; Charset=UTF-8; Boundary=PartA")
    if err != nil {
        // 解析失败时不要继续把 params 当成完整结果使用。
        panic(err)
    }
    fmt.Println(mediaType)       // text/html
    fmt.Println(params["charset"])  // UTF-8
    fmt.Println(params["boundary"]) // PartA
}

这里的“小写”只针对协议中的名称：媒体类型 Text/HTML 变成 text/html，参数键 Charset 变成 charset。值是另一回事，UTF-8、令牌或带引号的文本不会仅因为调用了解析函数就被强制小写。

读取参数时固定使用规范化键

实际代码通常关心 charset、boundary 或 filename。不要为每种输入大小写准备多个 map 键；解析器已经把属性名统一了，调用方只需要统一读取入口：

// parseBoundary 只返回可靠的 boundary，缺失和解析错误都交给调用方判断。
func parseBoundary(value string) (string, error) {
    _, params, err := mime.ParseMediaType(value)
    if err != nil {
        // 参数语法错误时，不能只看 mediaType 是否非空。
        return "", err
    }
    boundary, ok := params["boundary"]
    if !ok || boundary == "" {
        // 没有 boundary 不等于使用默认值，具体默认策略应由协议决定。
        return "", fmt.Errorf("missing boundary")
    }
    return boundary, nil
}

如果业务需要比较字符集名称，可以在业务层明确采用不区分大小写的比较策略；不要把“参数键规范化”误解成“所有参数值都规范化”。尤其是文件名、边界串或扩展参数，值的大小写可能仍是数据本身。

错误处理与 FormatMediaType 的往返边界

官方文档说明：可选参数解析失败时，函数可能返回已经识别出的媒体类型，同时返回 ErrInvalidMediaParameter。所以正确判断是先看 err，再决定是否消费 params；不能因为 mediatype 非空就跳过错误。

需要把结构重新编码成 MIME 值时，可以使用 mime.FormatMediaType。它也会把类型和参数名写成小写，但参数值按可序列化规则输出，非法组合会返回空字符串：

// buildContentType 统一生成可放回 HTTP 头的 MIME 值。
func buildContentType() (string, error) {
    // 名称会输出为小写；boundary 的值仍由调用方提供。
    value := mime.FormatMediaType("Multipart/Form-Data", map[string]string{
        "Boundary": "PartA",
    })
    if value == "" {
        // 空字符串代表参数组合不符合 MIME 语法，不能直接写入响应头。
        return "", fmt.Errorf("invalid media type")
    }
    return value, nil
}

读写两端可以共享同一套约定：输入解析后只按小写键查找；输出交给 FormatMediaType；需要保留值的业务语义时，单独记录值的大小写，不要依赖参数名的显示形式。

常见误区与复查清单

相关问题

为什么媒体类型也会转成小写？

媒体类型名称和参数名属于 MIME 语法中的名称，解析器按规范化形式返回，便于调用方不区分输入大小写进行判断。

参数值能不能直接全部转小写？

不能一概而论。字符集名称通常可以按不区分大小写处理，但边界串、文件名等值可能是业务数据，应保留原值。

参考资料：https://pkg.go.dev/mime。实际接收外部头字段时，建议把错误分支、缺失参数和空值分开记录。