只校验扩展名不可靠,因用户可随意篡改(如avatar.jpg.exe伪装为.jpg),filepath.Ext()仅取最后点后字符串,无法防御伪造;必须结合文件头魔数检测与MIME白名单校验。

只校验扩展名为什么不可靠?
用户上传的 avatar.jpg.exe 改个后缀就能绕过 .jpg 检查,浏览器和操作系统都认扩展名,但 Go 的 http.Request 不会自动解析它——你拿到的 filename 是客户端随便填的字符串,filepath.Ext() 只是取最后的点之后部分,毫无安全意义。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 扩展名检查仅作第一层快速过滤,不能作为判定依据
- 不要用
strings.HasSuffix(filename, ".png")做最终判断 - 若必须依赖扩展名(如生成存储路径),应与后续 MIME 或内容校验结果一致,否则拒绝
怎么正确读取并校验 MIME 类型?
HTTP 请求中 Content-Type 字段由客户端提供,可伪造;真正可信的是文件**前几百字节**的二进制特征。Go 标准库 net/http 提供了 http.DetectContentType(),它基于 magic bytes 实现,但注意:它只看前 512 字节,且不支持所有格式(比如 WebP 在旧 Go 版本中可能识别为 image/webp,而 Go 1.19+ 才稳定)。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 用
multipart.FileHeader.Open()获取io.Reader,再用io.LimitReader(r, 512)限制读取长度 - 调用
http.DetectContentType(buf)前确保buf至少有 512 字节(不足时用实际长度) - 对比白名单时,用
strings.HasPrefix(detected, "image/")而非完全相等,因为image/jpeg和image/jpg都可能被返回 - 避免直接信任
header.Header.Get("Content-Type")
如何做真正的文件内容校验(magic bytes)?
仅靠 http.DetectContentType() 还不够:它无法区分恶意构造的 PDF/HTML 混合文件,也无法识别被注入 shellcode 的图片。你需要更细粒度的校验,比如确认 PNG 文件以 \x89PNG\r\n\x1a\n 开头,或 JPEG 以 \xff\xd8\xff 开始。
实操建议:
立即学习“go语言免费学习笔记(深入)”;
- 对关键类型(如
image/png,image/jpeg,application/pdf)手写 magic bytes 检查,比通用检测更准 - 用
bytes.Equal(buf[:len(magic)], magic),而不是strings.Contains()(二进制数据不能当字符串) - PDF 文件需同时检查开头
%PDF-和结尾%%EOF(后者需读到末尾,慎用;生产环境建议用gofpdf或unidoc库做轻量解析) - 如果允许 SVG,必须额外做 XML 结构校验 + 禁止
<script></script>、onload等危险标签,单纯 magic bytes 不防 XSS
完整校验流程该按什么顺序执行?
顺序错了就可能浪费资源或漏检。典型错误是先解压 ZIP 再校验内容,结果发现根本不是 ZIP——应该层层递进,从快到慢、从廉价到昂贵。
推荐顺序:
- 第一步:检查
header.Size是否超出允许上限(如 10MB),超限直接拒绝 - 第二步:提取扩展名,做白名单快速过滤(如只允许
.png,.jpg,.pdf) - 第三步:读取前 512 字节,用
http.DetectContentType()得到候选 MIME - 第四步:根据扩展名 + MIME 组合,选择对应 magic bytes 规则做二进制校验
- 第五步:对特殊类型(如 ZIP、DOCX)做深度校验前,先确认是否真为该格式(比如 ZIP 必须以
PK\x03\x04开头),再决定是否调用archive/zip解析
最易被忽略的一点:每次读取文件流后,记得用 file.Seek(0, 0) 或重新 Open(),否则后续校验读不到数据——multipart.FileHeader 的底层 os.File 指针已经偏移了。


















