mime.TypeByExtension 返回空字符串是因为标准库仅内置极少数扩展名，其余需用 mime.AddExtensionType 主动注册，且必须在启动前单次调用、线程不安全，应集中注册或用 sync.Once 保护。
为什么 mime.TypeByExtension 返回空字符串？
直接调用 mime.TypeByExtension(".js") 却得到空字符串，不是 bug，是 Go 标准库的默认行为：它只内置了极少数扩展名（如 ".html"、".css"、".png"），其余一律返回空。静态资源服务里大量用到 ".ts"、".woff2"、".json" 等，靠默认表根本不够用。
解决方法不是自己硬编码映射表，而是用 mime.AddExtensionType 主动注册：
mime.AddExtensionType(".ts", "application/typescript")
mime.AddExtensionType(".woff2", "font/woff2")
mime.AddExtensionType(".json", "application/json")
注意两点：
- 必须在服务启动前调用，且仅需一次；多次调用同扩展名会 panic
- 类型字符串要符合 RFC 规范，比如不能写
"text/json"（不存在），得用"application/json" - Go 1.19+ 对
".webp"等新增格式仍不支持，默认返回空，必须手动补全
如何安全地 fallback 到 net/http.ServeContent 的自动检测？
http.ServeFile 和 http.ServeContent 内部其实会尝试调用 mime.TypeByExtension，但它们还留了一手：当该函数返回空时，会读取文件前几百字节做 magic number 检测（比如 PNG 文件头是 \x89PNG）。这个 fallback 很有用，但有代价：
立即学习“go语言免费学习笔记（深入）”；
- 触发 magic 检测需要打开并读取文件——对高频访问的小文件（如
favicon.ico）会增加 I/O 开销 - 某些格式（如 minified JS）无可靠 magic 字节，fallback 会失败，最终返回
text/plain - 如果你已用
mime.AddExtensionType显式注册过，就不会走 fallback，性能更稳
所以推荐策略：先注册常见扩展名，再让标准库处理剩余小众格式，而不是完全依赖 magic 检测。
静态文件路径带查询参数时，mime.TypeByExtension 还能用吗？
不能直接用。比如请求路径是 /assets/app.js?v=1.2.3，你若直接传整个路径给 mime.TypeByExtension，它会查 ".js?v=1.2.3" 这个扩展名——显然不存在，返回空。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
正确做法是先剥离查询参数，只提取真实文件扩展名：
import "net/url"
func getMimeType(path string) string {
u, _ := url.Parse(path)
ext := u.Path[strings.LastIndex(u.Path, "."):]
return mime.TypeByExtension(ext)
}
但更稳妥的是用 path/filepath.Ext：
import "path/filepath" ext := filepath.Ext(u.Path) // 自动忽略 query，返回 ".js"
注意：filepath.Ext 对 "/a/b/c." 返回 "."，对 "/a/b/c" 返回空字符串，使用前建议校验 ext != ""。
并发注册 MIME 类型是否线程安全？
不安全。mime.AddExtensionType 内部操作全局 map，Go 官方文档明确标注「not safe for concurrent use」。如果你在多个 goroutine 启动时都调用它，可能 panic 或静默失效。
典型错误场景：
- 每个 HTTP handler 都尝试注册
".svg" - 微服务里多个初始化 goroutine 并发调用
AddExtensionType
解决方案只有两个：
- 统一在
main()开头集中注册，确保单次、串行 - 用
sync.Once包一层（适合封装成可复用的初始化函数）
别图省事放 defer 或 init 函数里——init 是包级执行，多个包 init 并发，照样不安全。
