오디오 currentTime 을 바꿔도 처음부터 재생될 때 해결법

먼저 결론
증상: 앞부분을 들려주다가 완성된 파일로 갈아탈 때 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일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.