如何在 Go 中使用 net/http.DetectContentType 自动检测文件类型-Golang-PHP中文网

net/http.detectcontenttype仅基于前512字节魔数推测mime类型，专为http响应设计，不适用于通用文件检测；对pdf/docx等常返回application/octet-stream，应配合扩展名校验或改用gabriel-vasile/mimetype等专用库。

如何在 go 中使用 net/http.detectcontenttype 自动检测文件类型

net/http.DetectContentType 不是用来检测任意文件类型的，它只对前 512 字节的二进制数据做 MIME 类型推测，且仅支持有限的几种格式（如 HTML、XML、JSON、PNG、JPEG、GIF 等）。直接用它判断磁盘上一个 .pdf 或 .docx 文件的类型，大概率会返回 "application/octet-stream"。

为什么 DetectContentType 常常“失灵”

这个函数设计初衷是为 HTTP 响应体首部提供快速 guess，不是通用文件类型探测工具。它的逻辑非常简单：按固定顺序检查字节头（magic number），一旦匹配就返回对应 Content-Type；不匹配就兜底返回 "application/octet-stream"。

只读取输入的前 512 字节 —— 如果文件头被压缩、加密或偏移，就完全失效
不识别 ZIP 容器内的子类型（比如 .docx 是 ZIP，但内部 XML 结构不在检测范围内）
对文本类文件依赖 BOM 或开头标签，纯 ASCII 文本或无声明的 JSON 很容易被误判为 "text/plain; charset=utf-8"
不处理扩展名，也不查系统 /usr/share/mime 或其他数据库

正确使用 DetectContentType 的典型场景

它最靠谱的用法，是配合 http.Request.Body 或内存中刚读出的一小段原始数据（比如上传接口接收到的 []byte），且你明确知道数据未被截断或篡改。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

上传接口中，从 r.Body 读取前 512 字节后调用：

buf := make([]byte, 512)
n, _ := io.ReadFull(r.Body, buf)
contentType := http.DetectContentType(buf[:n])

不能直接传 os.Open("file.pdf") 的 *os.File，因为 DetectContentType 接收的是 []byte，不是 io.Reader
如果读不满 512 字节（比如文件本身小于 512 字节），传入实际长度即可，函数内部会处理

替代方案：什么时候该换更可靠的库

当你要处理磁盘文件、用户上传的完整附件、或需要识别 .xlsx / .woff2 / .webp 等较新格式时，net/http.DetectContentType 就不够用了。

推荐用 gabriel-vasile/mimetype：纯 Go，支持 300+ 类型，可读文件或 io.Reader，精度高

import "github.com/gabriel-vasile/mimetype"
mtype, _ := mimetype.DetectFile("report.docx")
fmt.Println(mtype.String()) // application/vnd.openxmlformats-officedocument.wordprocessingml.document

若已在用 cobra 或项目允许 CGO，libmagic 绑定（如 mxk/go-magic）更全面，但增加部署复杂度
永远别跳过扩展名校验 —— 检测结果和 filepath.Ext() 应交叉验证，比如 DetectContentType 返回 "image/jpeg" 但文件名是 avatar.js，大概率异常