Go mime.ExtensionsByType 返回空字符串怎样判断扩展名未识别

我第一次用 mime.ExtensionsByType 时，看到“没有对应扩展名”的结果，很自然地把它理解成了返回空字符串。真正容易混淆的地方是：这个函数根本不返回字符串，它做的是“从 MIME 类型反查扩展名”；返回空字符串的是另一个方向的 mime.TypeByExtension。

所以判断要分两条路：ExtensionsByType 看切片是否为 nil，同时处理 error；TypeByExtension 才检查结果是否为 ""。Go 官方文档还说明，反查结果会受系统 MIME 数据来源影响，不能把某个平台没有扩展名直接当成代码异常。

先分清两个函数的查询方向

ExtensionsByType(typ) 接受类似 image/jpeg 的 MIME 类型，返回扩展名切片和错误；找不到关联项时返回 nil, nil。它不会返回空字符串。相反，TypeByExtension(".jpg") 接受带点的扩展名，返回 MIME 字符串；完全不认识扩展名时才返回 ""。

package main

import (
    "fmt"
    "mime"
)

func main() {
    // 反查：一个 MIME 类型可能对应多个扩展名。
    exts, err := mime.ExtensionsByType("image/jpeg")
    if err != nil {
        fmt.Println("MIME 格式错误：", err)
        return
    }
    fmt.Printf("扩展名切片：%v，是否为空：%t\n", exts, exts == nil)

    // 正查：未知扩展名时，TypeByExtension 返回空字符串。
    typ := mime.TypeByExtension(".not-known")
    fmt.Printf("MIME 类型：%q，是否未识别：%t\n", typ, typ == "")
}

实际项目里，上传文件通常先拿扩展名正查 MIME；根据响应头或配置反推文件后缀时，才使用反查函数。把两个返回值的判断写反，是看到“空结果”时最常见的误判。

用 nil 与 error 判断反查结果

对 ExtensionsByType，先判断错误，再判断切片。未知 MIME 类型通常是 nil, nil；如果输入包含非法的媒体类型参数，函数会先经过 ParseMediaType，此时可能返回错误。这个顺序能把“输入格式不合法”和“格式合法但没有已知扩展名”区分开。

func extensionsFor(typ string) ([]string, error) {
    // 先保留解析错误，不把它误判为“没有扩展名”。
    exts, err := mime.ExtensionsByType(typ)
    if err != nil {
        return nil, fmt.Errorf("解析 MIME 类型 %q：%w", typ, err)
    }
    if exts == nil {
        // 合法但没有关联扩展名，是业务分支，不一定是异常。
        return nil, fmt.Errorf("MIME 类型 %q 没有已知扩展名", typ)
    }
    return exts, nil
}

如果业务允许未知类型继续处理，可以把 nil 分支改成默认后缀或人工确认；如果业务要求严格白名单，则在这里明确拒绝。不要只用 len(exts) == 0 代替所有判断，因为它会吞掉“没有结果”的语义，而忽略输入错误。

真正要判断扩展名未识别时用 TypeByExtension

标题里说的“返回空字符串”，对应的是 TypeByExtension。扩展名应带前导点，例如 .html；少了点，或者扩展名不在内置表、系统 MIME 数据库和注册表可见范围内，都可能得到空字符串。大小写查找也有边界：标准库会先尝试大小写敏感匹配，再尝试不区分大小写的匹配，但不要依赖它替代业务层的统一化。

func detectMIME(ext string) (string, error) {
    // 统一补上前导点，避免把“输入格式错”与“扩展名未知”混为一谈。
    if ext == "" {
        return "", fmt.Errorf("扩展名不能为空")
    }
    if ext[0] != '.' {
        ext = "." + ext
    }
    typ := mime.TypeByExtension(ext)
    if typ == "" {
        return "", fmt.Errorf("扩展名 %q 未识别", ext)
    }
    return typ, nil
}

这里的错误是业务包装，不是 TypeByExtension 自己返回的错误。这样写能让上层日志记录原始扩展名，也能把空输入、缺少前导点和未知扩展名分开处理。

需要自定义映射时先注册再反查

某个内部格式没有系统映射时，可以用 AddExtensionType 注册。扩展名必须以点开头，MIME 类型仍要符合媒体类型格式；注册成功后，正查和反查都会看到这条进程内映射。它改变的是当前进程的 MIME 表，不是系统文件关联，也不会替其他进程永久保存。

func registerAndLookup() error {
    // 注册内部格式；扩展名必须带点，类型参数保持标准 MIME 形式。
    if err := mime.AddExtensionType(".reportx", "application/x-reportx"); err != nil {
        return fmt.Errorf("注册 MIME 映射：%w", err)
    }

    // 正查确认扩展名映射已经存在。
    typ := mime.TypeByExtension(".reportx")
    if typ == "" {
        return fmt.Errorf("注册后仍未识别扩展名")
    }

    // 反查确认同一映射能返回扩展名集合。
    exts, err := mime.ExtensionsByType(typ)
    if err != nil {
        return fmt.Errorf("反查 MIME 映射：%w", err)
    }
    if len(exts) == 0 {
        return fmt.Errorf("MIME 类型 %q 没有扩展名", typ)
    }
    return nil
}

几个容易混淆的相关问题

• 为什么 ExtensionsByType 得到 nil？ 输入格式可能合法，但当前平台可见的 MIME 数据中没有该类型的扩展名。
• 为什么 TypeByExtension 得到空字符串？ 它没有找到对应扩展名；先确认是否带点，再确认是否需要 AddExtensionType。
• 注册后重启还在吗？ AddExtensionType 只影响当前进程，持久化配置要由应用自己管理。

记住一个简单区分：ExtensionsByType 看“切片加 error”，TypeByExtension 看“字符串是否为空”。先辨认查询方向，再决定空值策略，排查就不会绕回同一个误区。