HTTP Range와 206, 파일의 일부만 받는 응답 이해하기

페이지 정보

profile_image
작성자 관리자
댓글 0건 조회 234회 작성일 26-10-14 07:21

본문

큰 파일을 내려받다가 중간부터 다시 받거나 영상의 다른 위치로 이동할 때 파일 전체를 매번 가져오지 않는 방식이 필요할 수 있습니다. HTTP의 Range 요청은 자원의 일부 범위를 요청하는 기능이며, 서버가 이를 수행하면 206 Partial Content 응답을 볼 수 있습니다.

다만 헤더를 보냈다는 사실만으로 부분 응답이 보장되지는 않습니다. 이 글에서는 단일 바이트 범위를 중심으로 요청과 응답의 의미를 정리합니다.

숫자와 파일 크기는 설명을 위해 구성한 가상 예시입니다.

전체 파일에서 일부 범위를 선택하는 개념을 표현한 종이 묶음

AI 생성 삽화 · 개념 이해를 위한 AI 연출 이미지이며 실제 시스템 구성도나 측정 결과가 아닙니다.

핵심 정리
Range는 원하는 범위를 요청하고 Content-Range는 실제 응답의 범위를 설명합니다. 206·200·416을 구분하고 이어받기에서는 같은 파일 버전인지 확인한 뒤 데이터를 결합해야 합니다.


1. Range는 파일 내용의 일부를 지정하는 요청입니다

클라이언트는 GET 요청에 Range 헤더를 넣어 필요한 부분을 표현할 수 있습니다. 여기서는 bytes 단위를 사용하는 경우를 다룹니다.

파일의 특정 바이트 구간을 요청하는 것이므로 문서의 몇 번째 문단이나 영상의 몇 초 구간을 그대로 적는 방식은 아닙니다. 애플리케이션이 필요한 위치와 바이트 범위를 연결하는 일은 별도의 문제입니다.

같은 자원이라도 서버의 지원과 선택된 표현에 따라 응답이 달라질 수 있습니다. Accept-Ranges: bytes는 서버가 바이트 범위 요청을 지원한다는 안내로 볼 수 있습니다.

그러나 실제 클라이언트는 사전 안내만 믿고 응답 처리를 생략하지 말고 받은 상태와 헤더를 확인해야 합니다. 서버는 Range를 무시하고 전체 표현을 반환할 수도 있습니다.

부분 다운로드 기능을 만들 때에는 요청을 보낸 것과 서버가 그 요청을 수행한 것을 구분하는 것이 출발점입니다.

관련 공식 문서

관련 공식 문서


2. 바이트 위치는 시작과 끝을 포함해 읽습니다

가상 파일의 전체 길이가 6000바이트라고 가정합니다. Range: bytes=1000-1999는 1000번 위치부터 1999번 위치까지의 구간을 요청합니다.

바이트 위치는 0부터 시작하므로 이 구간의 길이는 1999에서 1000을 빼고 1을 더한 1000바이트입니다. 첫 1000바이트를 원한다면 0부터 999까지라는 점도 같은 계산으로 이해할 수 있습니다.

끝 위치를 생략하거나 뒤쪽 길이를 지정하는 형식도 있지만 이 글의 기본 예시는 시작과 끝이 있는 단일 범위입니다. 파일을 여러 조각으로 나눌 때 경계가 겹치거나 한 바이트가 빠지지 않도록 계산해야 합니다.

앞 구간의 끝이 1999라면 다음 구간의 시작은 2000입니다. 실제 구현에서는 파일의 길이와 서버의 응답 범위를 확인해야 하며 요청한 구간만 믿고 저장 위치를 확정하지 않습니다.

사람에게 익숙한 첫 번째라는 표현과 0부터 시작하는 위치 값을 혼동하지 않는 것이 중요합니다.

관련 공식 문서


3. 206 응답에서는 실제 범위와 길이를 확인합니다

서버가 앞의 요청에 단일 범위로 응답한다면 206 상태와 함께 Content-Range: bytes 1000-1999/6000 같은 정보를 받을 수 있습니다. 앞부분은 실제 반환한 구간이고 슬래시 뒤 숫자는 전체 표현의 길이를 나타냅니다.

이 예시의 본문은 전체 6000바이트가 아니라 해당 구간의 1000바이트입니다. Content-Length가 제공된다면 이 단일 범위 응답에서는 본문 길이를 뜻하며 전체 파일 크기로 읽어서는 안 됩니다.

Content-Range와 Content-Length가 역할이 다른 이유입니다. 여러 범위를 한 번에 요청하는 multipart 응답은 구조가 달라지므로 단일 범위 파서에 그대로 넣지 않습니다.

초기에 기능을 구현할 때에는 지원할 요청 형태를 제한하고 예상하지 않은 응답을 구분하는 편이 좋습니다. 받은 본문의 길이와 범위가 기대와 맞는지도 확인합니다.

206이라는 상태 코드 하나만 보고 모든 조각이 정상이라는 결론을 내리지 않습니다.

관련 공식 문서


4. 200과 416도 별도 흐름으로 처리합니다

Range를 요청했는데 200 OK로 전체 파일을 받았다면 기존 일부 파일의 뒤에 그대로 붙여서는 안 됩니다. 전체 표현을 받은 경우로 처리할지 다시 시작할지 애플리케이션 정책을 정해야 합니다.

조건부 범위 요청의 조건이 맞지 않을 때에도 전체 응답이 올 수 있습니다. 요청한 범위를 만족할 수 없는 경우에는 416 Range Not Satisfiable을 받을 수 있습니다.

예를 들어 길이가 6000바이트인 표현에서 7000번 위치부터 요청하는 상황은 확인이 필요한 범위입니다. 서버가 Content-Range: bytes */6000처럼 현재 전체 길이를 알려줄 수 있으므로 이를 해석해 저장 상태와 비교합니다.

416을 받았다는 이유만으로 로컬 파일이 완성되었다고 표시하지 않습니다. 원격 자원의 버전이나 길이가 바뀌었는지, 요청 계산이 잘못되었는지 확인해야 합니다.

상태별 처리를 구분하면 일부 응답을 전체 파일로 오인하거나 같은 데이터를 중복 저장하는 문제를 줄일 수 있습니다.

관련 공식 문서

관련 공식 문서


5. 이어받기에서는 자원의 버전도 확인합니다

파일의 앞부분을 받은 뒤 서버의 파일이 바뀌면 같은 주소에서 받은 뒷부분이라도 서로 다른 버전일 수 있습니다. 단순히 바이트 길이가 맞는다는 이유로 두 조각을 결합하면 내용이 섞일 수 있습니다.

If-Range는 저장한 표현의 검증 정보를 조건으로 범위 요청을 다루는 데 사용됩니다. 조건이 맞으면 범위 응답을 받을 수 있고 맞지 않으면 서버가 Range를 무시하고 전체 표현을 보낼 수 있습니다.

ETag 등을 사용할 때에는 해당 헤더의 요구 조건을 확인해야 하며 약한 ETag를 그대로 If-Range에 사용하는 방식은 피해야 합니다. 날짜 기반 조건에도 적용 요건이 있으므로 어떤 문자열이나 넣어도 된다고 생각하지 않습니다.

클라이언트는 이전 응답의 검증 정보와 저장한 범위를 함께 관리합니다. 버전이 달라졌다는 신호를 받으면 기존 조각에 무조건 이어 붙이지 않는 흐름이 필요합니다.

이어받기는 전송 위치뿐 아니라 어떤 표현을 이어받는지 확인하는 작업입니다.

관련 공식 문서


6. 작은 가상 파일로 저장 결과를 검증합니다

실제 대용량 파일부터 시험하기보다 내용과 길이를 아는 작은 파일로 범위 계산을 확인할 수 있습니다. 첫 구간, 중간 구간, 마지막 구간을 받아 결합한 결과가 원본과 같은지 비교합니다.

서버가 전체 200 응답을 주는 경우와 범위를 만족하지 못하는 416도 별도로 시험합니다. 다운로드 도중 원격 파일이 바뀌는 상황을 만들고 버전 조건에 따라 전체 응답을 처리하는지 확인할 수 있습니다.

응답 헤더를 기록할 때에는 요청 범위와 실제 범위, 본문 길이를 구분합니다. 압축이나 다른 표현 선택이 관여하면 어느 표현의 바이트를 다루는지 추가로 확인해야 합니다.

Range는 내용을 일부 선택하는 의미이며 네트워크 전송이 내부적으로 여러 조각으로 나뉘는 것과 같은 개념은 아닙니다. 요청 수를 많이 늘리면 언제나 빨라진다는 보장도 없습니다.

기능의 목적과 서버 정책을 고려해 범위와 동시 요청 수를 정하고, 완료 판정은 조각 수가 아니라 실제 결과의 일관성을 기준으로 합니다.

관련 공식 문서


7. 자주 묻는 질문

Q1. Range를 보냈으면 반드시 206이 와야 합니까?

서버가 범위 요청을 무시하거나 조건에 따라 전체 200 응답을 보낼 수 있습니다. 클라이언트는 상태 코드와 실제 범위를 확인하고 전체 응답을 기존 조각에 그대로 이어 붙이지 않아야 합니다.

Q2. bytes=0-999는 999바이트입니까?

시작과 끝을 모두 포함하므로 1000바이트입니다. 연속 구간을 만들 때에는 다음 시작 위치를 1000으로 정하는 식으로 경계의 중복과 누락을 확인합니다.

Q3. Content-Length만 보면 전체 파일 크기를 알 수 있습니까?

단일 206 응답에서는 해당 응답 본문의 길이를 뜻할 수 있어 전체 길이와 다릅니다. 전체 표현의 길이와 반환 범위는 Content-Range 등 응답 정보를 함께 읽어 확인해야 합니다.

Q4. 416이 나오면 이미 파일을 다 받은 것입니까?

그 상태만으로 다운로드 완료를 판단할 수는 없습니다. 요청 범위 계산과 현재 원격 표현의 길이·버전, 저장한 데이터의 상태를 확인한 뒤 완료 여부를 결정해야 합니다.


참고 자료

댓글목록

등록된 댓글이 없습니다.