Go mime.ParseMediaType 返回类型和错误同时存在时该怎么处理

处理 HTTP 头部时，mime.ParseMediaType 并不只有“成功”或“失败”两种结果：媒体类型本身已经识别出来，但可选参数格式错误时，返回值里可能同时有非空的 mediatype 和 error。这时应把它理解为“类型部分可用、参数部分不可用”，而不是忽略错误继续使用整组结果。

如果 err 是 mime.ErrInvalidMediaParameter，可以按业务需要保留已经解析出的媒体类型，但不要把 params 当成完整、可信的参数映射；严格协议则应直接拒绝。

先分清 ParseMediaType 的三种返回组合

官方文档把返回值定义为媒体类型、参数映射和错误三部分。成功时媒体类型会转成小写并去掉首尾空白，参数键也按小写保存；如果出错点在可选参数，媒体类型仍会返回，但会伴随 mime.ErrInvalidMediaParameter。

其中第二行最容易误判：类型已经返回，不代表参数也解析成功。当前实现对这种可选参数解析失败会返回 mediatype, nil, mime.ErrInvalidMediaParameter；调用方应先判断错误，再决定是否只使用类型。

用 errors.Is 判断“类型可用、参数失效”

不要只写 if err != nil { return err }，也不要只看 mediatype != ""。前者会错过允许类型降级的场景，后者则可能把坏参数当成合法输入。推荐把错误类型和返回值组合放在同一个分支里：

package main

import (
    "errors"
    "fmt"
    "mime"
)

func acceptMediaType(raw string) (string, error) {
    mediatype, params, err := mime.ParseMediaType(raw)
    if err != nil {
        // 参数坏了但类型存在：这里只允许类型级路由，不读取 params。
        if mediatype != "" && errors.Is(err, mime.ErrInvalidMediaParameter) {
            fmt.Printf("参数无效，保留类型 %q\n", mediatype)
            return mediatype, nil
        }
        // 类型本身都无法识别时，不能再做内容类型判断。
        return "", err
    }

    // 无错误时，参数映射才可以参与 charset 等后续策略。
    _ = params["charset"]
    return mediatype, nil
}

这里的降级只适合“我只需要知道它属于哪一类”的代码，例如日志分组或粗粒度路由。如果后续要根据 charset 解码、根据 boundary 进入协议解析，参数是输入契约的一部分，就不应返回成功。

按协议目标选择严格拒绝还是类型降级

判断标准不是“有没有拿到一个字符串”，而是后续逻辑是否依赖参数。下面这张图把同一个返回组合对应到三种消费边界：严格校验需要完整结果，类型路由只依赖 mediatype，日志记录则应保留错误信息而不是伪装成成功。

还要注意，params 是 map，读取不存在的键不会报错，但这不代表参数解析成功。把空字符串当成默认字符集或默认边界，可能把格式问题悄悄转成错误业务行为。

用四组边界样例补齐回归检查

测试时至少覆盖完整参数、缺少等号、媒体类型缺少斜杠和尾部分号。尾部分号属于实现允许的宽松输入，而缺少参数值则应进入错误分支。断言不要只检查 err，还应检查类型和参数映射的组合：

tests := []struct {
    name, raw, wantType string
    wantErr             error
    wantCharset         string
}{
    {"完整参数", "text/plain; charset=utf-8", "text/plain", nil, "utf-8"},
    {"参数缺值", "text/plain; charset", "text/plain", mime.ErrInvalidMediaParameter, ""},
    {"尾分号", "text/plain; charset=utf-8;", "text/plain", nil, "utf-8"},
    {"类型缺斜杠", "plain; charset=utf-8", "", nil, ""},
}

for _, tt := range tests {
    // 逐项核对类型、错误和参数，避免只测到一个返回字段。
    gotType, gotParams, gotErr := mime.ParseMediaType(tt.raw)
    _ = gotParams["charset"]
    _ = gotType
    _ = gotErr
}

正式测试中应把占位的赋值替换为断言：对“参数缺值”确认 errors.Is(gotErr, mime.ErrInvalidMediaParameter) 且类型仍为 text/plain；对“类型缺斜杠”确认不能进入类型路由。这样才能把部分成功和整体失败分开。

Go mime.ParseMediaType 常见问题

返回了非空 mediatype，是不是可以忽略 err？

不能。非空类型只说明媒体类型部分已识别；是否可降级要看错误种类和业务是否依赖参数。

ErrInvalidMediaParameter 时 params 一定有内容吗？

不要依赖它有内容。可选参数解析失败时应把映射视为不可用，只在无错误分支读取参数。

为什么 errors.Is 比直接比较更合适？

标准库当前返回的是哨兵错误，但用 errors.Is 表达“按错误语义判断”，以后即使错误被包装也更稳妥。

只做日志记录也要区分这类错误吗？

要区分。日志可以记录已经识别的类型，但必须同时保留错误和原始头部，避免异常输入被统计成正常请求。