Go mime.AddExtensionType 怎样注册业务文件的媒体类型

Go 可以在程序启动时调用 mime.AddExtensionType(".后缀", "媒体类型")，为业务文件建立扩展名映射，再用 mime.TypeByExtension 查询。注册影响当前进程使用的mime映射，不会修改操作系统关联，也不会读取文件内容来证明实际格式。

官方文档：https://pkg.go.dev/mime

前置条件：先确认需要的是扩展名约定

假设业务导出一种任务包，后缀为.taskpkg，下载模块希望为它返回稳定的类型字符串。应用可以集中注册这条约定，减少每个调用点都写一段后缀判断。这里解决的是名称到类型的映射，不是压缩包解析、上传内容检查或浏览器文件关联。

示例使用application/x-example-taskpkg作为本地演示名称，不表示该类型已在IANA登记。对外协议应使用项目实际约定或已有标准类型，不要因为AddExtensionType接受了字符串就宣称完成了媒体类型标准注册。

初始化：后缀带点，错误必须返回

AddExtensionType的第一个参数是扩展名，必须以点开头。应传.taskpkg，而不是taskpkg，更不是daily.taskpkg。第二个参数应是符合媒体类型语法的字符串；无效输入会返回错误，不能忽略后继续启动依赖这条映射的服务。

建议把注册项放在可追踪的启动函数中，在启动处理请求的goroutine之前完成。这样初始化失败能带着明确阶段返回，也避免多个业务模块在运行中反复争相改写同一后缀。这里选择显式启动函数，而不是在init里隐藏错误处理。

编写代码：注册后从文件名提取后缀查询

package main

import (
    "fmt"
    "mime"
    "path/filepath"
)

const (
    businessExt  = ".taskpkg"
    businessType = "application/x-example-taskpkg"
)

func registerBusinessTypes() error {
    // 示例类型名只是应用约定，不表示已在 IANA 正式登记。
    if err := mime.AddExtensionType(businessExt, businessType); err != nil {
        return fmt.Errorf("注册业务媒体类型：%w", err)
    }
    return nil
}

func mediaTypeFor(name string) (string, error) {
    // TypeByExtension 接收带点后缀，不能直接传完整文件名。
    ext := filepath.Ext(name)
    if ext == "" {
        return "", fmt.Errorf("文件名没有扩展名")
    }
    typ := mime.TypeByExtension(ext)
    if typ == "" {
        return "", fmt.Errorf("没有找到后缀 %q 的媒体类型", ext)
    }
    return typ, nil
}

func run() error {
    // 在处理文件和启动请求服务之前集中注册。
    if err := registerBusinessTypes(); err != nil {
        return err
    }
    for _, name := range []string{"daily.taskpkg", "DAILY.TASKPKG"} {
        typ, err := mediaTypeFor(name)
        if err != nil {
            return err
        }
        fmt.Printf("%s -> %s\n", name, typ)
    }
    return nil
}

func main() {
    if err := run(); err != nil {
        fmt.Println("初始化或查询失败：", err)
    }
}

业务常量与初始化逻辑集中在一起，便于项目维护。mediaTypeFor先用filepath.Ext取得扩展名，再交给TypeByExtension。完整文件名、路径和URL都不是这个查询函数直接需要的参数；如果输入是URL，应先按URL规则取得路径，不能把查询串当作文件后缀的一部分。

示例没有创建或打开daily.taskpkg。传入的名称只参与后缀提取，因此即使磁盘上没有这个文件，也可以得到映射。这一点正好说明查询不能证明文件存在或内容正确。

运行检查：大小写与未知后缀分别看待

# 在保存独立示例 main.go 的目录运行，程序只注册映射并打印查询值。
go run main.go

按代码语义，两个示例名称都应查询到application/x-example-taskpkg。TypeByExtension先按大小写精确查找，再尝试不区分大小写的映射；本例只注册一种小写形式，不人为制造相互冲突的大小写条目。这是预期行为说明，不是本机运行日志。

没有扩展名与扩展名未识别是两种情况，示例为它们返回不同错误。不要把未知映射默默解释成文件无效：某个业务文件是否允许上传或下载，应由应用规则决定。需要回退为application/octet-stream时，也应把它写成明确的产品选择。

扩展实验：注册是进程状态，不是系统安装

可以在自己的项目中分别尝试缺少前导点的后缀、语法无效的类型字符串和不存在的后缀，并观察错误与空结果的区别。对已有后缀再次注册可能改变它在当前进程的映射，因此不要随意覆盖.json或.html等常用后缀，更不要让普通请求参数直接控制注册项。

注册并不会写入系统mime.types文件，也不会设置桌面程序的默认打开方式。进程重新启动后，应再次执行启动注册逻辑。若另一个服务或浏览器要理解该业务格式，它也需要自己的协议配置，不能共享这个Go进程的内存状态。

标准库初始映射可能受到平台系统表的补充，所以不要把本机查询到的所有默认值视为跨环境固定清单。对于项目自行定义的后缀，在启动阶段明确注册并统一维护，通常比依赖部署机器碰巧具有的系统记录更易解释。

清理与维护：没有产生文件，也没有注销句柄

这个实验只更改进程内状态，不需要删除演示文件，因为程序没有生成文件。mime包没有对应的公开RemoveExtensionType接口；测试或临时实验不应假设可以随时撤销注册。需要彼此隔离的业务规则时，可以使用应用自己的map，而不是频繁改全局mime映射。

注册成功就能保证文件安全了吗？不能。重命名即可改变后缀，文件格式与内容规则必须另外检查。

重启后还在吗？应用应在每次进程启动时重新注册；它不是永久系统配置。

不同租户能给同一后缀定义不同含义吗？需要这种隔离时，建议把映射放在租户自己的配置对象中，不直接复用进程级注册表来表达不同含义。

参考：mime.AddExtensionType文档；Go官方mime映射实现。