증상: 앞부분을 들려주다가 완성된 파일로 갈아탈 때
currentTime 을 설정해도 소리가 처음부터 다시 났습니다.원인: 서버가 Range 요청을 처리하지 않고
accept-ranges 헤더도 주지 않아 브라우저가 건너뛰기를 포기했습니다.해결: 서버가
bytes=시작-끝 을 읽어 206 으로 그 구간만 보내게 하고, 화면은 loadedmetadata 뒤에 자리를 옮긴 다음 재생합니다.갈아타는 순간 처음으로 돌아가던 소리
만드는 데 시간이 걸리는 음성 파일을 다루는 화면이었습니다. 다 만들어질 때까지 기다리게 하지 않으려고 앞부분 조각을 먼저 들려주고, 완성본이 나오면 같은 자리부터 이어서 들려주는 구조였습니다.
그런데 완성본으로 바꾸는 순간 소리가 맨 앞에서 다시 시작했습니다. 화면 코드에서 currentTime 을 이어 들을 자리로 아무리 설정해도 먹지 않았습니다. 화면 코드만 고쳐서는 풀리지 않았습니다.
브라우저는 건너뛰기 전에 서버에 묻는다
브라우저가 소리 파일의 중간으로 건너뛰려면 서버에 "몇 바이트부터 주세요"라고 묻습니다. 이것이 Range 요청입니다. 서버가 이 요청을 받아 그 구간만 돌려줘야 중간 재생이 됩니다.
서버에 그 처리가 없고 응답에 accept-ranges 헤더도 없으면, 브라우저는 이 파일은 건너뛸 수 없다고 보고 처음부터 틉니다. 그래서 화면만 고치면 영원히 안 됩니다. 원인이 서버 응답에 있었기 때문입니다.
| 요청 | 서버가 줘야 할 응답 | 함께 줄 헤더 |
|---|---|---|
| Range 헤더 없음 | 200, 파일 전체 | accept-ranges: bytes, content-length |
Range: bytes=1000-2000 |
206, 그 구간만 | content-range: bytes 1000-2000/크기, content-length |
| 시작 위치가 파일 크기 이상 | 416 | content-range: bytes */크기 |
끝만 파일 크기를 넘는 요청(bytes=4000-9999 같은 것)은 416 이 아니라 끝을 파일 끝으로 잘라 206 으로 줍니다. 200, 206, 416 의 뜻은 HTTP 표준 문서(RFC 9110)에 정해진 것입니다. 정적 파일을 nginx 같은 웹 서버가 직접 내보내면 보통 이 처리를 알아서 해 주지만, 노드 서버에서 파일을 직접 읽어 보내면 직접 써 줘야 합니다.
노드 서버에 넣은 코드
Range 헤더를 정규식으로 풀고, 시작과 끝을 계산해 그 구간만 스트림으로 보냅니다. bytes=-500 처럼 시작이 비어 있으면 "끝에서 500바이트"라는 뜻이라 따로 계산합니다.
const head = { 'content-type': 'audio/mpeg', 'accept-ranges': 'bytes' }
const m = /^bytes=(\d*)-(\d*)$/.exec(req.headers.range || '')
if (m) {
const start = m[1] === '' ? Math.max(0, size - Number(m[2])) : Number(m[1])
const end = m[2] === '' || m[1] === '' ? size - 1 : Math.min(Number(m[2]), size - 1)
if (start > end || start >= size) {
res.writeHead(416, { ...head, 'content-range': `bytes */${size}` })
return res.end()
}
res.writeHead(206, { ...head,
'content-range': `bytes ${start}-${end}/${size}`,
'content-length': end - start + 1 })
return fs.createReadStream(file, { start, end }).pipe(res)
}
res.writeHead(200, { ...head, 'content-length': size })
fs.createReadStream(file).pipe(res)
여기서 size 는 fs.statSync(file).size 로 미리 얻은 파일 크기입니다. createReadStream 의 end 는 그 바이트까지 포함하므로 content-length 는 끝 빼기 시작 더하기 1 입니다.
화면 쪽은 순서가 반이다
서버를 고친 뒤에도 화면 코드의 순서가 틀리면 다시 처음부터 날 수 있습니다. play() 를 먼저 부르고 자리 옮기기를 따로 걸면, 브라우저에 따라 옮기기가 씹혔습니다. 자리를 먼저 옮기고 그다음에 틉니다.
el.src = url
el.addEventListener('loadedmetadata', () => {
el.currentTime = resumeAt // 길이를 안 뒤에 옮기고
void el.play().catch(() => {}) // 옮긴 다음에 튼다
}, { once: true })
el.load()
loadedmetadata 는 브라우저가 파일 길이를 알게 된 시점입니다. 그 전에는 옮길 자리가 파일 안에 있는지조차 모릅니다.
함께 겪은 작은 문제도 하나 적습니다. 재생 위치 막대를 ontimeupdate 로 그리면 이 이벤트가 250ms 에 한 번쯤만 불려 막대가 뚝뚝 끊깁니다. 재생 중일 때만 requestAnimationFrame 으로 매 프레임 currentTime 을 읽어 그리면 부드럽습니다.
curl 한 줄로 확인
화면을 열기 전에 서버가 제대로 답하는지 먼저 봅니다.
curl -I -H "Range: bytes=1000-2000" https://example.com/audio/sample.mp3
- 첫 줄이 206 이고
content-range: bytes 1000-2000/전체크기가 보이면 정상입니다 - 200 이 나오면 서버가 Range 헤더를 무시하고 있습니다
accept-ranges: bytes가 빠져 있으면 브라우저가 건너뛰기를 시도하지 않을 수 있습니다
주소가 다른 주소로 넘겨지는 곳이라면 -L 을 빼먹어 넘김 응답만 보고 판단하기 쉽습니다. curl 로 실제 서버 응답을 볼 때의 이런 실수는 curl 로 라이브 반영을 확인할 때 저지른 세 가지 실수에 모았습니다.
CDN 이나 캐시를 거치는 주소라면 캐시가 옛 응답을 줄 수도 있으니, 헤더를 볼 때 캐시 상태도 함께 봅니다. 캐시 때문에 고친 것이 안 보이는 경우는 수정이 화면에 안 보일 때 캐시 확인법에 적었습니다. 고친 뒤 접속 로그를 보면 같은 파일에 206 이 여러 줄 찍힙니다. 건너뛸 때마다 새 구간을 묻기 때문이라 오류가 아닙니다. 로그 숫자로 상태를 판정할 때 흔히 틀리는 점은 서버 로그로 상태를 판정하다 틀리는 실수에 따로 적었습니다.
이 글의 내용은 2026년 10월 22일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.