Worker API in Next.js — 시리즈 안내
작성일:2025.05.26|수정일:2026.11.14|조회수:1

브라우저에서 돌아가는 코드가 많아지면 큰 계산과 중복 연결이 한꺼번에 문제가 되기 시작한다. 큰 배열을 한 번 계산했을 뿐인데 입력이 끊기고, 같은 서비스를 여러 탭에 열었더니 서버 연결도 탭 수만큼 늘어난다. Next.js에서는 여기에 한 가지가 더 붙는다. 지금 보고 있는 코드가 서버에서 평가되는지, 브라우저에서 실행되는지도 계속 의식해야 한다.
Worker API는 이 문제들을 한꺼번에 해결해주지 않는다. 작업과 연결을 지금과 다른 실행 컨텍스트로 옮기면 데이터 전달, 생명주기, 배포 조건을 직접 설계해야 한다. 그래서 Worker를 쓸지 판단하는 일과 Worker를 만드는 일은 분리해서 생각해야 한다.
서로 다른 두 문제가 같은 질문으로 모인다
화면을 멈추게 하는 계산은 메인 스레드가 너무 많은 일을 소유한 문제다. 탭마다 생기는 소켓은 각 탭이 같은 종류의 연결을 따로 소유한 문제다. 전자는 한 화면의 작업을 밖으로 옮기면 되고, 후자는 여러 화면이 공유할 자원을 별도의 실행 컨텍스트가 맡아야 한다.
이 차이 때문에 Dedicated Worker와 SharedWorker를 같은 사용법의 변형으로 보면 자꾸 설명이 꼬인다. Dedicated Worker는 특정 화면이나 기능과 수명을 함께하는 작업에 잘 맞는다. SharedWorker는 같은 브라우저 안의 여러 탭이 함께 쓰는 자원을 맡는다. 이름은 비슷하지만 소유 범위가 다르다.
시리즈에서 다루는 세 가지 결정
1편에서는 느린 코드에 async를 붙이는 것과 Worker로 계산을 옮기는 것이 왜 다른지 정리한다. 메인 스레드, CPU 작업, structured clone, transferable object를 살펴보면서 내 작업이 데이터 이동 비용을 감수하고도 Worker로 옮길 만한지 판단한다.
2편에서는 Dedicated Worker를 Next.js 클라이언트 코드에 연결한다. 정적인 Worker 진입점, React effect의 setup과 cleanup, 요청 ID, transferable buffer를 하나의 예제로 묶는다. Worker와 진행 중인 작업의 수명을 누가 소유하는지에 초점을 맞춘다.
3편에서는 SharedWorker가 Socket.IO 연결 하나를 여러 탭에 제공하는 구조를 만든다. 각 탭은 MessagePort로 명령을 보내고, Worker가 소켓 상태와 서버 이벤트를 다시 브로드캐스트한다. 포트 정리, 인증 컨텍스트, 미지원 환경의 fallback까지 포함해야 비로소 “소켓 하나”라는 말이 실제 구조가 된다.
어디서부터 읽을 것인가
Worker가 필요한지부터 의심스럽다면 1편부터 읽는다. 이미 큰 계산을 메인 스레드 밖으로 옮기기로 결정했다면 2편으로 가도 된다. 문제의 시작이 멀티탭 소켓 중복이라면 3편부터 읽어도 되지만, 메시지 전달 비용과 실행 컨텍스트의 분리가 낯설다면 1편을 먼저 읽는 쪽이 덜 헷갈린다.
이 시리즈는 Worker API 전체 명세나 서버 측 Worker Threads를 다루지 않는다. Worker를 도입해야 한다고 주장하지도 않는다. 계산을 옮길 때 생기는 비용과 자원을 공유할 때 생기는 책임을 보고, 지금 문제에 맞는 소유 범위를 고르는 데까지만 간다.
댓글
댓글을 불러오는 중...