在派發靜態資源或驗證使用者上傳檔案時,僅憑副檔名判斷類型往往會引發正式環境臭蟲。例如,內容建置管線經常將 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