[디버깅] macOS 메타데이터 파일 중복 (__MACOSX, ._ 파일)

[al-bur]

증상

ZIP 파일 압축 해제 시 파일이 2배로 나옴

원인

macOS에서 생성된 ZIP 파일에는 리소스 포크(Resource Fork) 메타데이터가 포함됨:

• __MACOSX/ 폴더 내의 파일들
• ._ 접두사가 붙은 파일들 (예: ._원천징수.pdf)

이 파일들은 macOS 전용 메타데이터로, 실제 콘텐츠가 아님

해결

JSZip으로 ZIP 추출 시 해당 파일들을 필터링:

// macOS 메타데이터 파일 건너뜀
if (path.startsWith("__MACOSX/") || path.includes("/._") || path.startsWith("._")) continue

교훈

• ZIP 파일에는 OS별 메타데이터가 포함될 수 있음
• macOS의 __MACOSX 폴더와 ._ 파일은 항상 필터링 필요
• 디버깅 시 실제 데이터를 로깅해서 확인하는 것이 중요