글을 삭제하시겠습니까?

삭제한 글은 복구할 수 없습니다.

2. Dedicated Worker를 Next.js에서 안전하게 쓰기

작성일:2025.05.26|수정일:2026.11.14|조회수:1

2. Dedicated Worker를 Next.js에서 안전하게 쓰기

Worker를 만드는 코드는 생각보다 짧다. new Worker()를 호출하고 메시지를 보내면 된다. 그런데 Next.js 화면에 실제로 붙이기 시작하면 더 중요한 코드가 주변에 생긴다. Worker 파일을 번들러가 찾을 수 있어야 하고, React가 effect를 다시 실행해도 이전 인스턴스가 남지 않아야 하며, 늦게 도착한 응답이 최신 화면을 덮지 않아야 한다.

그래서 Dedicated Worker를 안전하게 쓰는 문제의 핵심은 소유권이다. 큰 숫자 배열을 변환하는 작은 예제로 Worker 인스턴스, 진행 중인 요청, 전달한 버퍼의 수명을 한곳에 묶어본다. 예제는 Next.js 16.4.6의 기본 Turbopack에서 production build와 브라우저 실행을 확인했다.

Worker 진입점을 정적으로 선언한다

예제의 Worker 진입점은 다음과 같다.

TS
const worker = new Worker(  new URL('../workers/number.worker.ts', import.meta.url),  { type: 'module' },);

Turbopack는 이 new URL()을 보고 Worker 파일을 별도 진입점으로 추적한다. 여기서 확인한 범위는 new Worker(new URL('정적 문자열', import.meta.url), 옵션)처럼 직접 중첩된 형태다. 경로를 동적으로 조합하거나 URL을 다른 변수에 뺀 코드까지 같게 처리된다고 가정하지 않는다.

Worker는 브라우저 API이므로 생성은 클라이언트 전용 단계에서 일어나야 한다. 파일에 'use client'가 있더라도 컴포넌트 렌더링 중에 외부 리소스를 만들 이유는 없다. effect의 setup에서 Worker를 만들고 cleanup에서 종료하면 React가 개발 모드에서 setup과 cleanup을 추가로 검증하더라도 같은 대칭 구조를 반복할 수 있다.

effect가 Worker의 수명을 소유한다

아래 컴포넌트는 Worker를 effect에서 만들고 ref에 보관한다. 화면에 보여야 하는 결과만 state에 두고, Worker 인스턴스와 현재 요청 ID는 렌더링을 일으키지 않는 ref로 관리한다.

TSX
'use client';import { useCallback, useEffect, useRef, useState } from 'react';type WorkerResponse =  | { type: 'done'; requestId: string; buffer: ArrayBuffer; elapsedMs: number }  | { type: 'error'; requestId: string; message: string };export function DedicatedWorkerDemo() {  const workerRef = useRef<Worker | null>(null);  const pendingRequestRef = useRef<string | null>(null);  const [result, setResult] = useState<string>('아직 실행하지 않음');  useEffect(() => {    const worker = new Worker(      new URL('../workers/number.worker.ts', import.meta.url),      { type: 'module' },    );    const failCurrentRequest = (message: string) => {      if (!pendingRequestRef.current) return;      pendingRequestRef.current = null;      setResult(message);    };    const handleMessage = (event: MessageEvent<WorkerResponse>) => {      const message = event.data;      if (message.requestId !== pendingRequestRef.current) return;      pendingRequestRef.current = null;      if (message.type === 'error') {        setResult(message.message);        return;      }      const values = new Uint32Array(message.buffer);      setResult(`${values[0]} / ${message.elapsedMs.toFixed(1)}ms`);    };    const handleError = (event: ErrorEvent) => {      failCurrentRequest(event.message || 'Worker 실행 중 오류가 발생했다.');    };    const handleMessageError = () => {      failCurrentRequest('Worker 응답을 해석하지 못했다.');    };    worker.addEventListener('message', handleMessage);    worker.addEventListener('error', handleError);    worker.addEventListener('messageerror', handleMessageError);    workerRef.current = worker;    return () => {      worker.removeEventListener('message', handleMessage);      worker.removeEventListener('error', handleError);      worker.removeEventListener('messageerror', handleMessageError);      worker.terminate();      workerRef.current = null;      pendingRequestRef.current = null;    };  }, []);  const run = useCallback(() => {    const worker = workerRef.current;    if (!worker) return;    const requestId = crypto.randomUUID();    const values = new Uint32Array(250_000);    for (let index = 0; index < values.length; index += 1) values[index] = index;    pendingRequestRef.current = requestId;    setResult('계산 중');    try {      worker.postMessage(        { type: 'transform', requestId, buffer: values.buffer },        [values.buffer],      );    } catch (error) {      pendingRequestRef.current = null;      setResult(error instanceof Error ? error.message : 'Worker 요청 전송 실패');    }  }, []);  return (    <section>      <h2>Dedicated Worker</h2>      <button type="button" onClick={run}>계산 시작</button>      <output>{result}</output>    </section>  );}

이 코드에서 빈 dependency 배열은 “어떤 상황에서도 정확히 한 번만 생성된다”는 약속이 아니다. effect setup 하나마다 cleanup 하나가 대응해야 한다. cleanup은 이벤트 리스너를 제거하고 Worker를 terminate()한 뒤, ref에 남은 현재 요청도 지운다.

오류 처리도 같은 소유권 안에 있다. Worker가 실행 중 오류를 내면 error 이벤트가 발생하고, 받은 메시지를 역직렬화하지 못하면 messageerror가 발생할 수 있다. 반대로 clone할 수 없는 값을 보낼 때는 postMessage() 호출 자체가 동기적으로 실패할 수 있으므로 전송 지점의 try/catch도 필요하다.

요청 ID가 오래된 응답을 밀어낸다

사용자가 계산 버튼을 빠르게 여러 번 누르면 Worker에는 여러 작업이 순서대로 들어간다. 예제는 각 요청에 requestId를 넣고, 컴포넌트가 마지막으로 보낸 ID와 일치하는 응답만 화면에 반영한다. 이전 계산이 실제로 취소되는 것은 아니지만, 적어도 오래된 결과가 최신 결과를 덮지는 않는다.

이 차이는 중요하다. 응답을 무시하는 것과 작업을 취소하는 것은 다르다. 계산 자체를 중단해야 한다면 Worker에 취소 명령을 보내 작업을 잘게 나누거나, Worker를 종료하고 새로 만드는 정책이 필요하다. 여기서는 “마지막 요청의 결과만 유효하다”는 단순한 정책을 선택했다.

Worker 쪽도 요청 ID를 그대로 돌려준다. 메시지 프로토콜이 있어야 여러 작업이 같은 Worker를 사용할 때 어떤 결과가 어느 요청에 속하는지 알 수 있다.

큰 버퍼는 복사하지 않고 돌려받는다

예제는 Uint32Array의 기반 ArrayBuffer를 Worker로 transfer한다. 전송 직후 메인 스레드가 갖고 있던 버퍼는 detach되므로, 컴포넌트는 그 배열을 다시 사용하지 않는다. Worker가 계산을 끝내면 같은 버퍼의 소유권을 메인 스레드로 돌려준다.

TSX
/// <reference lib="webworker" />type TransformRequest = {  type: 'transform';  requestId: string;  buffer: ArrayBuffer;};self.addEventListener('message', (event: MessageEvent<TransformRequest>) => {  const { requestId, buffer } = event.data;  try {    const startedAt = performance.now();    const values = new Uint32Array(buffer);    for (let index = 0; index < values.length; index += 1) {      let next = values[index] ?? 0;      for (let round = 0; round < 100; round += 1) {        next = (next * 17 + round) % 65_521;      }      values[index] = next;    }    self.postMessage(      { type: 'done', requestId, buffer, elapsedMs: performance.now() - startedAt },      { transfer: [buffer] },    );  } catch (error) {    self.postMessage({      type: 'error',      requestId,      message: error instanceof Error ? error.message : '알 수 없는 오류',    });  }});

Worker 파일은 화면을 모른다. 버튼, loading 문구, React state가 없고 { type, requestId, buffer }를 받아 계산한 뒤 { type, requestId, buffer, elapsedMs }를 보낼 뿐이다. 이 정도로 입력과 출력이 좁아지면 계산 코드는 React 밖에서 따로 검증하기도 쉬워진다.

전송 옵션이 빠지면 큰 버퍼는 왕복 과정에서 structured clone 대상이 된다. transfer는 그 비용을 줄일 수 있지만 언제나 더 빠르다고 단정할 수는 없다. 버퍼를 다시 구성하는 비용과 계산량, 실제 데이터 크기를 함께 측정해야 한다.

Worker를 붙인 뒤 무엇이 달라졌는지 본다

버튼을 눌러 결과가 나왔다고 작업이 끝난 것은 아니다. Performance 패널에서 메인 스레드의 긴 작업이 줄었는지, Worker 계산 중에도 입력과 애니메이션이 반응하는지 확인해야 한다. 메시지 준비와 결과 반영이 길다면 병목이 Worker 바깥으로 옮겨갔을 수도 있다.

개발 모드의 Strict Mode에서도 Worker 인스턴스가 남지 않는지, 버튼을 연속으로 눌렀을 때 마지막 결과만 보이는지, 컴포넌트가 사라진 뒤 응답이 와도 state를 바꾸지 않는지 살펴본다. 배포 결과물에서는 Worker 파일이 실제로 로드되는지도 확인해야 한다.

Dedicated Worker를 쓴다는 것은 계산 함수를 다른 파일로 옮기는 일이 아니다. Worker 인스턴스와 요청과 데이터의 소유권을 하나의 생명주기로 묶는 일이다. 이 소유권이 분명해야 메인 스레드에서 계산을 덜어낸 뒤에도 다른 종류의 누수를 만들지 않는다.

댓글

댓글을 삭제하시겠습니까?

삭제한 댓글의 내용은 복구할 수 없습니다.

댓글을 불러오는 중...