在分发静态资源或校验用户上传文件时,仅凭文件扩展名判断类型往往会引发生产环境故障。例如,内容构建流水线经常将 WebP 或 AVIF 图像保存为遗留的 .jpg 后缀,而配置不当的 S3 上传任务则常常回退为默认的 application/octet-stream 或 text/plain。
当你将名为 product-hero.jpg 的本地文件拖入检测器时,工具会在内存中切片读取起始字节,并将二进制签名与扩展名映射结果进行比对:
Filename: product-hero.jpg
Header Hex (0x00): 52 49 46 46 24 A1 01 00 57 45 42 50 56 50 38 58
Header ASCII: R I F F $ . . . W E B P V P 8 X
该文件开头并不是 JPEG 的图像起始标记(FF D8 FF),其 0x00–0x03 字节为 RIFF,且 0x08–0x0B 字节包含 WEBP。检测器会立即标记扩展名不匹配,并生成准确的 HTTP 元数据诊断报告:
{
"fileName": "product-hero.jpg",
"claimedExtension": ".jpg",
"claimedMimeType": "image/jpeg",
"detectedMagicHex": "52 49 46 46 ?? ?? ?? ?? 57 45 42 50",
"detectedMimeType": "image/webp",
"extensionMismatch": true,
"charsetRequired": false,
"compressible": false,
"recommendedHeaders": [
"Content-Type: image/webp",
"X-Content-Type-Options: nosniff"
]
}
对于没有固定二进制魔数签名的纯文本资源(例如 .mjs 或 .js 等 ES 模块),检索目录即可输出完全符合 RFC 9239 规范的响应头配置,直接用于 Nginx、Cloudflare Workers 或 S3 元数据设置:
Content-Type: text/javascript; charset=utf-8
X-Content-Type-Options: nosniff