Huny's Dev Blog
huny.dev

Node.js 23·24 런타임 3대 도구 혁신 해부: require(ESM) 동기 상호운용·네이티브 타입스크립트(strip-types)·내장 SQLite(node:sqlite)

Node.js 23과 24에서 단행된 CJS-ESM 장벽을 허무는 require(ESM) 기본 활성화(--no-experimental-require-module), 외부 번들러 없는 네이티브 TypeScript 실행(strip-types), 외부 C 바인딩 없는 제로 디펜던시 내장 SQLite(node:sqlite DatabaseSync)와 로컬 Python 6대 시뮬레이션 검증을 살펴본다.

Hun Jang
Hun Jang Nov 16, 2026

Node.js 23·24 런타임 3대 도구 혁신 (require(ESM), strip-types, node:sqlite) 개념 추상 아트워크

자바스크립트와 타입스크립트 생태계는 지난 10여 년간 비약적인 언어적 발전을 이루었지만, 동시에 파편화된 모듈 시스템(CommonJS vs ES Modules), 복잡하게 얽힌 빌드 파이프라인(tsc, babel, ts-node, esbuild, bundlers), 그리고 네이티브 C 바인딩(node-gyp, python 빌드 툴체인)에 의존하는 로컬 데이터베이스 설치 문제로 인해 개발자 경험(DX) 측면에서 상당한 피로도를 축적해 왔다. 특히 라이브러리 작성자들을 괴롭혔던 'CJS/ESM 듀얼 패키지 지옥(Dual Package Hazard)'과 단순 스크립트 실행조차 별도 번들러 설정을 요구하던 관행은 현대 웹 개발의 대표적인 병목이었다.

최신 Node.js 23과 24 라인업은 이러한 생태계의 고질적인 분열과 빌드 오버헤드를 뿌리부터 걷어내는 3대 코어 도구 혁신을 런타임 정식 수준으로 단행했다 (Node.js 23 Release Announcement). CommonJS 코드베이스에서 외부 ES 모듈을 동기식으로 즉시 호출할 수 있도록 기본 전환된 require(ESM) 동기 상호운용 브리지, 외부 트랜스파일러나 빌드 단계 없이 .ts 파일을 즉시 실행하는 네이티브 TypeScript 스트리핑(strip-types), 그리고 외부 네이티브 컴파일러 설치 없이 단 한 줄의 임포트로 메모리 및 파일 RDBMS를 구동하는 **코어 내장 SQLite(node:sqlite)**가 그 핵심이다.

핵심 판단 기준을 먼저 요약하면, Node.js 23부터 기본 활성화된 require(ESM)은 정적 모듈 로더 레벨에서 Top-Level Await(TLA)가 없는 완전 동기식 ES 모듈을 감지하여 CommonJS의 동기 실행 흐름 안으로 무지연 로드하며, 평가된 exports 객체를 require.cache에 동기식으로 캐싱한다. 만약 대상 모듈에 TLA가 포함되어 비동기 프로미스를 반환해야 한다면 즉시 ERR_REQUIRE_ASYNC_MODULE을 던져 런타임 교착과 동기 오염을 원천 차단하며, 특수 레거시 환경을 위한 --no-experimental-require-module 롤백 플래그를 제공한다. 한편 네이티브 TypeScript 실행(--experimental-strip-types 및 23·24 기본화)은 무거운 타입 검사를 전면 생략하고 SWC 기반 파서로 오직 타입 어노테이션과 인터페이스만 공백(Whitespace)으로 치환하여 V8에 전달함으로써 소스 맵 매핑 오프셋과 런타임 에러 줄 번호를 100% 보존한다. 단, JS 객체 코드를 직접 생성해야 하는 enum, namespace, parameter properties 같은 비지우기(Non-erasable) 구문은 컴파일 불가로 거부된다. 마지막으로 코어에 내장된 node:sqlite(DatabaseSync)는 Python의 내장 sqlite3처럼 V8 메모리 아이솔레이트와 C++ SQLite3 엔진을 제로 카피로 직결하여 better-sqlite3 수준의 동기 쿼리 성능을 외부 node-gyp 의존성 없이 제공한다. 이 글은 공식 Node.js 23 Release Notes, Node.js 기술 문서(Modules: ECMAScript modules, TypeScript Support, node:sqlite Documentation)를 교차 검증해 정리한 분석이며, 공식 런타임 명세와 로컬 Python 6대 시뮬레이션 검증을 기준으로 설명한다.

1. CJS-ESM 10년 전쟁의 종결: require(ESM) 동기 상호운용과 TLA 제약 메커니즘

자바스크립트 생태계에서 가장 악명 높았던 오류 중 하나는 CommonJS 파일에서 최신 ESM 라이브러리를 require()할 때 발생하던 ERR_REQUIRE_ESM 예외였다. CommonJS는 함수 호출 스택 기반의 완전 동기 로딩 방식인 반면, ES 모듈 명세는 최상위 대기(top-level await)를 허용하는 비동기 모듈 그래프 파싱 및 인스턴스화 라이프사이클을 갖기 때문에 두 시스템 간의 동기 결합이 기술적으로 불가능하다고 여겨져 왔다.

이로 인해 커뮤니티는 import() 동적 비동기 로딩을 강제받거나, 동일한 라이브러리를 CJS용과 ESM용으로 이중 빌드하여 배포하는 극심한 오버헤드를 감당해야 했다. Node.js 23은 이 문제를 다음과 같은 정교한 조건부 동기 브리지 아키텍처로 해결했다 (Node.js require(ESM) Specification):

  1. 정적 그래프 동기 평가 (Synchronous Graph Evaluation):
      • CJS 파일에서 require('./module.mjs') 또는 package.json의 "type": "module" 스코프 내 파일을 호출하면, Node.js 모듈 로더는 해당 파일과 모든 하위 종속성을 파싱하여 모듈 레코드(Module Record) 트리를 구성한다.
      • 모듈 트리의 모든 노드에 최상위 대기(top-level await)가 존재하지 않는 경우, 런타임은 모듈을 동기식으로 즉시 평가(EvaluateSync)한다.
  1. 동기 캐시 등록 및 exports 반환:
      • 성공적으로 평가된 ESM의 네임스페이스 객체(Module Namespace Exotic Object)는 CJS의 표준 require.cache에 캐싱된다.
      • CJS 코드는 일반 CJS 모듈을 가져왔을 때와 동일하게 반환값을 즉시 동기 변수에 할당해 사용할 수 있다.
  1. 비동기 격리 및 즉시 예외 분기 (ERR_REQUIRE_ASYNC_MODULE):
      • 만약 로드하려는 ESM 파일이나 그 하위 종속성 트리 중 단 하나라도 Top-Level Await 구문을 포함하고 있다면, 동기식 require()는 절대 블로킹되거나 비동기 프로미스를 어설프게 반환하지 않는다.
      • 런타임은 즉시 명시적인 ERR_REQUIRE_ASYNC_MODULE 예외를 던져 개발자에게 동적 import()를 사용하도록 유도하며, 동기 호출 스택의 오염을 원천 차단한다.
  1. 안전한 레거시 롤백 옵션 (--no-experimental-require-module):
      • 모듈 로딩 가로채기(Monkey-patching)나 레거시 로더 도구를 사용하는 특수 엔터프라이즈 환경에서 기존의 엄격한 거부 동작이 필요하다면 CLI 플래그 --no-experimental-require-module을 지정하여 이전의 ERR_REQUIRE_ESM 거부 모드로 롤백할 수 있다.

2. 혼동하기 쉬운 4가지 기술 경계 및 런타임 동작 비교

Node.js 23과 24의 신규 도구 기능들을 실무 프로덕션 및 CI/CD 환경에 도입할 때 다음 네 가지 기술 경계를 명확히 구분해야 한다:

  • strip-types는 "타입 검사기(Type Checker)"가 아니라 "타입 지우개(Type Stripper)"다: Node.js는 실행 시 타입 유효성을 전혀 검증하지 않는다. 잘못된 타입(const x: number = "hello";)이 포함되어 있어도 오류 없이 실행된다. 타입 검사는 개발 단계의 IDE(LSP)와 CI 파이프라인의 tsc --noEmit에 전적으로 위임해야 한다.
  • require(ESM)은 오직 "완전 동기식 ESM"에만 적용된다: 모듈 내부에서 await fetch(...)나 await initDb() 같은 최상위 대기 구문을 단 한 줄이라도 사용하는 순간 require()는 실패한다. 비동기 초기화가 필수적인 ESM은 여전히 최상위 await import(...) 체인을 유지해야 한다.
  • node:sqlite의 DatabaseSync는 메인 스레드 블로킹 동기 API다: DatabaseSync는 libuv의 비동기 워커 스레드 풀을 거치지 않고 V8 메인 스레드에서 SQLite C API를 직접 호출한다. 따라서 수십만 건의 대규모 테이블 스캔 쿼리를 웹 요청 핸들러 안에서 실행하면 Node.js 이벤트 루프 전체가 일시 정지될 수 있다.
  • 지울 수 있는 구문(Erasable Syntax)과 비지우기 구문(Non-erasable Syntax)은 엄격히 분리된다: 순수 타입 정의(인터페이스, 타입 별칭, 인자 타입, 반환 타입)는 단순 텍스트 삭제로 자바스크립트가 되지만, enum이나 namespace는 런타임 자바스크립트 객체(var Direction; (function(Direction){...}))를 생성해야 하므로 지우기 전용 엔진에서는 지원될 수 없다.
비교 항목
기존 Node.js (v20 이하)
Node.js 23·24 신규 아키텍처
실무 도입 및 제어 방법
CJS에서 ESM 로딩
require() 불가 (ERR_REQUIRE_ESM 패닉), 동적 import() 필수
require(ESM) 동기 로딩 기본 활성화 (TLA 없는 동기 모듈 대상)
기본 활성화. 롤백 필요 시 --no-experimental-require-module
TypeScript 실행
tsc 빌드 후 node dist/ 실행 또는 tsx/ts-node 러너 필수
strip-types 네이티브 실행 (SWC 기반 제로 컴파일 공백 치환)
node app.ts 직접 실행 (erasableSyntaxOnly 권장)
로컬 SQLite 지원
better-sqlite3, sqlite3 (node-gyp, Python, C++ 컴파일러 필수)
node:sqlite (코어 내장 DatabaseSync) Zero-dependency
import { DatabaseSync } from 'node:sqlite' (외부 설치 0개)
소스 맵 오프셋 보존
트랜스파일러 변환 시 소스 맵(.map) 파일 및 런타임 매핑 오버헤드
줄/열 번호 1:1 보존 (타입 주석을 동일 길이 공백으로 치환)
스택 트레이스에 원본 .ts 파일의 정확한 줄 번호 즉시 출력

3. Node.js 23·24 코어 런타임 및 도구 아키텍처 심층 분석

Node.js 23·24 런타임 3대 도구 혁신 (require(ESM) 동기 브리지, strip-types 네이티브 TypeScript 파이프라인, node:sqlite 코어 직결 아키텍처) 상세 다이어그램

3.1 strip-types: SWC 기반 공백 치환(Whitespace Replacement)과 소스 맵 무결성

Node.js에 내장된 타입 스트리퍼는 무거운 타입 체커를 탑재하지 않고, 초고속 Rust 기반 파서 엔진(SWC)을 활용해 자바스크립트 표준 문법에 해당하지 않는 타입 어노테이션 영역만을 안전하게 제거한다 (Node.js TypeScript Documentation):

  1. 오프셋 보존형 공백 치환 (In-place Whitespace Masking):
      • 만약 function add(a: number, b: number): number라는 코드에서 : number를 완전히 잘라내어 줄이면 텍스트 열(column) 오프셋이 변경되어 디버깅 시 오차가 발생한다.
      • Node.js의 타입 스트리퍼는 타입 어노테이션 텍스트를 동일한 바이트 수의 공백 문자( )로 치환한다.
      • 여러 줄에 걸친 interface나 type 선언 블록은 줄바꿈(\n)을 그대로 유지한 채 내부 내용만 공백으로 치환한다.
      • 따라서 별도의 외장 소스 맵(.js.map) 파일을 생성하거나 파싱하지 않고도, V8 엔진이 던지는 런타임 스택 트레이스의 파일명과 줄 번호, 열 번호가 원본 .ts 소스와 100% 일치한다.
  1. 트랜스파일 파이프라인 부하 0 (Zero-Build Runtime):
      • 개발 환경에서 tsx나 ts-node 같은 로더를 로드할 때 발생하던 수백 밀리초의 부트스트랩 지연이 사라진다.
      • CI/CD 파이프라인이나 마이크로서비스 컨테이너 배포 시 빌드 산출물 디렉터리(dist/)를 별도로 관리할 필요 없이 .ts 파일을 원본 그대로 실행할 수 있다.

3.2 Non-Erasable 구문(enum, namespace) 차단과 TypeScript 5.8 erasableSyntaxOnly

타입스크립트의 모든 문법이 타입 스트리핑의 대상이 될 수 있는 것은 아니다. TC39의 'Types as Comments' 제안(Proposal) 표준화 원칙에 따라, **오직 텍스트를 지웠을 때 온전한 자바스크립트가 되는 구문(Erasable Syntax)**만이 네이티브 실행을 지원받을 수 있다:

  • 차단되는 비지우기 구문 (Non-Erasable):
    • enum: 런타임에 역방향 매핑을 제공하는 자바스크립트 객체를 즉석에서 생성해야 한다.
    • namespace: IIFE 클로저 패턴으로 런타임 스코프 객체를 생성해야 한다.
    • 생성자 매개변수 프로퍼티(constructor(public name: string)): 인스턴스 멤버 변수 초기화 코드로 변환되어야 한다.
  • 실무 대응책:
    • enum 대신 const 객체와 유니언 타입(const Status = { OK: 200 } as const; type Status = typeof Status[keyof typeof Status];)을 채택한다.
    • 최신 TypeScript 컴파일러 설정(tsconfig.json)에 "erasableSyntaxOnly": true 및 "verbatimModuleSyntax": true를 선언하면, IDE가 비지우기 구문 작성 시 즉시 경고를 띄워 실수를 미연에 방지할 수 있다.

3.3 node:sqlite: V8 Isolate 직결과 C++ 의존성 지옥 탈출

임베디드 데이터베이스나 로컬 캐시, 경량 웹 서비스에서 SQLite는 사실상 글로벌 표준이다. 하지만 Node.js 생태계에서 SQLite를 사용하려면 better-sqlite3 같은 네이티브 애드온 모듈을 설치해야 했고, 이는 항상 다음과 같은 운영 고통을 수반했다:

  • 클라우드 컨테이너(Alpine Linux, Distroless)나 크로스 아키텍처(x86-64 vs Arm64, Apple Silicon) 환경에서 node-gyp, Python, gcc/clang 빌드 툴체인 부재로 인한 npm install 실패.
  • Node.js 메이저 버전 업그레이드 시 ABI 불일치로 인한 NODE_MODULE_VERSION 충돌 및 재컴파일 강제.

Node.js의 node:sqlite는 공식 SQLite 3 C 라이브러리를 Node.js 코어 바이너리 내부에 직접 번들링했다 (Node.js node:sqlite API):

  • DatabaseSync 클래스:
    • const db = new DatabaseSync(':memory:') 또는 파일 경로를 지정해 즉시 인스턴스를 생성한다.
    • db.exec(sql)로 DDL 테이블 생성 및 인덱스 생성을 처리한다.
    • db.prepare(sql)로 준비된 명령문(Prepared Statement) 객체를 생성하고, stmt.run(...params), stmt.all(...params), stmt.get(...params) 메서드로 SQL 인젝션 없는 안전한 파라미터 바인딩 쿼리를 수행한다.
  • V8 Isolate 제로 카피 인터페이스:
    • C++ 레벨에서 SQLite의 메모리 버퍼와 V8 힙 메모리 객체를 직접 변환하여 외부 N-API 래퍼 레이어의 오버헤드를 대폭 줄였다.

4. 실무 설정·코드 예제와 로컬 Python 6대 검증 스크립트

4.1 Node.js 23·24 실무 코드 예제

아래 코드는 TypeScript 소스(service.ts)에서 내장 node:sqlite를 사용해 인메모리 데이터베이스를 제어하고, 기존 CommonJS 레거시 모듈(index.cjs)에서 이를 require()하여 동기식으로 호출하는 최신 패턴을 보여준다:

실행 방법:

4.2 로컬 Python 6대 런타임 불변식 검증 스크립트

아래 Python 스크립트는 Node.js 23·24의 6대 핵심 아키텍처 규칙(require(ESM) 동기 로딩 및 TLA 감지 시 ERR_REQUIRE_ASYNC_MODULE 거부, --no-experimental-require-module 옵트아웃 시 구형 ERR_REQUIRE_ESM 폴백, strip-types AST 타입 어노테이션 제거 및 오프셋 보존, enum/namespace 비지우기 구문 차단, node:sqlite DatabaseSync DDL/Prepared Statement 바인딩, CJS/ESM/TS/SQLite 통합 파이프라인 무결성)을 완벽히 검증한다:

실행 결과:

5. 실무 도입 및 프로덕션 마이그레이션 체크리스트

CommonJS 프로젝트의 ESM 호출 구문 간소화: ERR_REQUIRE_ESM 때문에 억지로 사용하던 복잡한 동적 const mod = await import('esm-pkg') IIFE 패턴을 단순한 const mod = require('esm-pkg') 동기 구문으로 리팩터링하여 코드 복잡성을 낮춘다.

Top-Level Await 종속성 감사: require(ESM) 대상 라이브러리가 내부에 TLA를 포함하고 있는지 확인한다. TLA가 포함된 라이브러리는 ERR_REQUIRE_ASYNC_MODULE을 던지므로 동적 import()를 유지해야 한다.

TypeScript 설정 파일(tsconfig.json) 정비: 네이티브 strip-types 호환성을 확보하기 위해 compilerOptions에 "module": "NodeNext", "verbatimModuleSyntax": true, "erasableSyntaxOnly": true를 선언하여 IDE 단계에서 비지우기 구문(enum, namespace) 작성을 원천 차단한다.

스크립트 및 개발 러너에서 번들러 제거: 단순 유틸리티 스크립트나 마이크로서비스 실행 시 무겁게 의존하던 ts-node, tsx, tsc 빌드 단계를 제거하고 node app.ts 단일 명령으로 파이프라인을 경량화한다.

로컬 캐시 및 임베디드 RDBMS의 node:sqlite 전환: better-sqlite3나 sqlite3를 사용하던 프로젝트에서 node-gyp C++ 컴파일러 의존성을 제거하고 표준 라이브러리인 node:sqlite의 DatabaseSync로 마이그레이션하여 Docker 컨테이너 이미지 크기를 대폭 감축하고 크로스 플랫폼 빌드 실패를 예방한다.

메인 스레드 블로킹 쿼리 분리: DatabaseSync는 동기식이므로 CPU 및 I/O 부하가 큰 대량 배치 쿼리는 별도의 Worker Threads(worker_threads)로 격리하여 웹 서버의 메인 이벤트 루프 지연을 방지한다.

6. 참고 자료 및 공식 출처 (2026-11-16 확인)

확인 기준일: November 16, 2026

추천 글