다운로드 파일의 한글 이름이 깨지면 Content-Disposition 확인
Content-Disposition은 본문을 표시할지 첨부로 내려받게 할지와 제안 파일명을 전달하는 데 쓰입니다. 서버 저장 파일 이름이 맞아도 응답 헤더가 잘못되면 브라우저에 다른 이름이 보일 수 있습니다.
먼저 기억할 핵심
- 다운로드 이름은 URL 파일명과 다를 수 있습니다
- 공백·한글 인코딩과 구문을 확인합니다
- 지원 브라우저에서 실제 저장을 시험합니다
다운로드 이름은 URL 파일명과 다를 수 있습니다
Content-Disposition은 본문을 표시할지 첨부로 내려받게 할지와 제안 파일명을 전달하는 데 쓰입니다. 서버 저장 파일 이름이 맞아도 응답 헤더가 잘못되면 브라우저에 다른 이름이 보일 수 있습니다.
공백·한글 인코딩과 구문을 확인합니다
filename과 UTF-8 filename* 표현의 조건을 문서에 맞춰 확인합니다. 원래 이름에 경로 문자열이나 제어 문자가 섞이지 않도록 처리합니다. 사용자가 준 이름을 검증 없이 헤더에 그대로 넣지 않습니다.
지원 브라우저에서 실제 저장을 시험합니다
본문이 맞는지와 저장 이름이 맞는지를 따로 확인합니다. CDN이나 프록시가 이전 헤더를 저장했는지도 비교합니다. 파일 확장자만 고쳐 다른 형식을 가장하지 말고 올바른 Content-Type도 함께 제공해야 합니다.
서버 운영 실행 전 점검표
- 다운로드 이름은 URL 파일명과 다를 수 있습니다
- 공백·한글 인코딩과 구문을 확인합니다
- 지원 브라우저에서 실제 저장을 시험합니다
이 가이드의 근거 문서
출처 확인일: 2026-11-04. 공식 문서에 기반한 편집 가이드이며 직접 수행한 벤치마크가 아닙니다. 비용 사례는 명시된 가정에 한합니다.
오류 제보 방법