HEAD 요청은 본문을 받지 않고 무엇을 확인할까

HEAD는 본문 대신 메타데이터를 받는 요청입니다

HEAD로 알 수 있는 것은 같은 자원에 GET을 보냈을 때 서버가 제공할 응답 헤더입니다. 큰 파일의 미디어 형식이나 길이 같은 정보를 살펴보는 데 유용하지만 파일이 올바르게 열리는지, PDF 내용이 기대한 문서인지까지 확인하지는 못합니다. HEAD 성공은 본문 검증의 대체 결과가 아닙니다. 근거: MDN HEAD, 2026-11-04 확인.

근거: MDN HEAD 요청 메서드 · 2026-11-04 확인

먼저 확인할 파일과 접근 권한을 정합니다

자신이 관리하거나 조회가 허용된 파일 주소를 준비합니다. 로그인이나 서명 URL이 필요한 자원은 인증 조건이 있는 그대로 시험해야 합니다. 공개 파일의 응답과 로그인 뒤 파일의 응답을 섞어 비교하지 않습니다. 서명 URL의 쿼리와 쿠키는 기록을 공유하기 전에 제거합니다. 비용이 발생하는 저장소라면 메타데이터 요청의 과금 정책도 확인합니다.

근거: MDN HEAD 요청 메서드 · 2026-11-04 확인

명령의 결과는 상태·종류·길이 순서로 읽습니다

미실행 예제 명령은 curl --head https://example.com/report.pdf 입니다. example.com은 설명용 주소이므로 실제 파일 확인에는 허가된 주소로 바꿔야 합니다. 출력에서 HTTP 상태와 Location, Content-Type, Content-Length, ETag 또는 Last-Modified를 순서대로 메모합니다. 처음 응답이 3xx라면 이동 안내를 받은 것이지 최종 PDF 응답을 확인한 것이 아닙니다. 최종 주소가 허가한 대상인지 확인한 뒤 그 응답을 따로 봅니다.

근거: MDN HEAD 요청 메서드 · 2026-11-04 확인

Content-Length는 HEAD 본문의 크기가 아닙니다

HEAD에는 응답 본문이 없으며 Content-Length가 있다면 GET으로 보낼 본문의 길이를 설명합니다. 따라서 숫자가 크고 실제로 받은 본문이 없다는 상황은 모순이 아닙니다. 헤더가 빠졌다고 파일을 0바이트로 적지도 않습니다. 길이를 확인하지 못했다고 기록하고 다운로드가 허용되면 실제 GET으로 받은 바이트를 점검합니다.

목적에 따라 완료 조건이 달라집니다

목적이 메타데이터 조회라면 최종 자원의 상태와 필요한 헤더를 확인한 것으로 해당 작업을 마칠 수 있습니다. 목적이 파일 납품 검수라면 GET으로 파일을 받고 실제 열림·페이지·내용을 확인해야 합니다. 이미지라면 디코딩과 실제 크기를, 문서라면 예상 본문과 손상 여부를 확인합니다. 이 글의 명령은 실행 결과가 아니므로 다운로드나 검수 성공 수치를 제시하지 않습니다.

HEAD가 안 될 때 본문을 추정하지 않습니다

405 등으로 메서드를 허용하지 않거나 인증 오류가 나면 HEAD 미지원·접근 조건을 먼저 확인합니다. HEAD 실패만으로 파일 삭제를 단정하지 않습니다. 허가된 GET이 가능하면 필요한 범위의 실제 응답으로 확인하되 대용량 전송 비용에 유의합니다. 서버가 HEAD에 본문을 잘못 보냈더라도 그 내용을 정상 HEAD 결과로 활용하지 않고 구현 점검 항목으로 남깁니다.

옆 문서로 이어가기