정적 에셋을 서빙하거나 사용자 업로드를 검증할 때 파일명 확장자에만 의존하면 프로덕션 버그가 자주 발생합니다. 콘텐츠 파이프라인에서 WebP나 AVIF 이미지를 레거시 .jpg 확장자로 저장하거나, 잘못 설정된 S3 업로드가 application/octet-stream 또는 text/plain으로 폴백(fallback)되는 일이 빈번합니다.
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의 이미지 시작(SOI) 마커(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"
]
}
ES 모듈(.mjs 또는 .js)처럼 바이너리 매직 시그니처가 없는 텍스트 기반 에셋의 경우, 디렉터리를 검색하면 Nginx, Cloudflare Workers 또는 S3 메타데이터에 바로 적용할 수 있는 RFC 9239 호환 헤더 블록을 출력합니다:
Content-Type: text/javascript; charset=utf-8
X-Content-Type-Options: nosniff