DEV WIKI
백엔드 · 기술

Node.js

Node.js는 브라우저 밖의 서버와 명령줄 환경에서 JavaScript를 실행하는 런타임입니다.

적용 범위
Node.js의 개념·동작을 확인해야 하는 공개 웹 환경문맥: 바이브 코딩
출처
Node.js
출처 확인일
2026-07-27
최종 검토
2026-07-27
수정일
2026-09-03
오류·수정 제보 (새 창에서 열림)

정상 동작 조건

요약

Node.js는 JavaScript 코드를 서버와 명령줄 환경에서 실행하는 런타임입니다. 오류를 확인할 때는 Node.js 버전, 실행 명령, 모듈 해석과 환경 변수를 같은 실행 환경에서 비교해야 합니다.

확인 절차

Node.js는 브라우저 밖에서 JavaScript를 실행하는 런타임입니다. 같은 코드라도 Node.js 버전과 실행 방식이 다르면 내장 API, 모듈 해석과 패키지 설치 결과가 달라질 수 있습니다.

오류 확인 순서

  1. 오류가 발생한 명령과 현재 Node.js 버전을 기록합니다.
  2. package.json의 engines, 패키지 관리자와 lockfile을 확인합니다.
  3. 로컬·CI·배포 환경의 환경 변수와 작업 디렉터리를 비교합니다.
  4. 버전이나 설정을 바꾼 뒤 같은 명령과 입력으로 재실행합니다.

HTTP 또는 net 요청 로그에 ECONNRESET, read ECONNRESET, socket hang up이 표시되면 ECONNRESET 확인 절차에서 요청·응답 단계와 재사용 소켓 여부를 구분합니다.

관련 오류·증상

ECONNRESET (Connection reset by peer)

Node.js의 ECONNRESET 원인을 요청 단계, 응답 중단, 재사용 소켓과 호출 코드의 연결 종료로 나눠 확인합니다.

Missing Env Value

Next.js 공식 원문에 표시된 Missing Env Value 항목의 문구를 확인하는 문서입니다.

ABORT_ERR

ABORT_ERR 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_ACCESS_DENIED

ERR_ACCESS_DENIED 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_AMBIGUOUS_ARGUMENT

ERR_AMBIGUOUS_ARGUMENT 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_ARG_NOT_ITERABLE

ERR_ARG_NOT_ITERABLE 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_ASSERTION

ERR_ASSERTION 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_ASYNC_CALLBACK

ERR_ASYNC_CALLBACK 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_BROTLI_COMPRESSION_FAILED

ERR_BROTLI_COMPRESSION_FAILED 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_BUFFER_CONTEXT_NOT_AVAILABLE

ERR_BUFFER_CONTEXT_NOT_AVAILABLE 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_BUFFER_OUT_OF_BOUNDS

ERR_BUFFER_OUT_OF_BOUNDS 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_BUFFER_TOO_LARGE

ERR_BUFFER_TOO_LARGE 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_CANNOT_WATCH_SIGINT

ERR_CANNOT_WATCH_SIGINT 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_CHILD_CLOSED_BEFORE_REPLY

ERR_CHILD_CLOSED_BEFORE_REPLY 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_CLOSED_MESSAGE_PORT

ERR_CLOSED_MESSAGE_PORT 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_CONSOLE_WRITABLE_STREAM

ERR_CONSOLE_WRITABLE_STREAM 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_CONSTRUCT_CALL_INVALID

ERR_CONSTRUCT_CALL_INVALID 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_CONTEXT_NOT_INITIALIZED

ERR_CONTEXT_NOT_INITIALIZED 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_CPU_PROFILE_ALREADY_STARTED

ERR_CPU_PROFILE_ALREADY_STARTED 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_CRYPTO_CUSTOM_ENGINE_NOT_SUPPORTED

ERR_CRYPTO_CUSTOM_ENGINE_NOT_SUPPORTED 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_CRYPTO_ECDH_INVALID_FORMAT

ERR_CRYPTO_ECDH_INVALID_FORMAT 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_DIR_CLOSED

ERR_DIR_CLOSED 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_DLOPEN_DISABLED

ERR_DLOPEN_DISABLED 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_DLOPEN_FAILED

ERR_DLOPEN_FAILED 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_ENCODING_INVALID_ENCODED_DATA

ERR_ENCODING_INVALID_ENCODED_DATA 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_FS_CP_DIR_TO_NON_DIR

ERR_FS_CP_DIR_TO_NON_DIR 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_FS_CP_EEXIST

ERR_FS_CP_EEXIST 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_FS_CP_EINVAL

ERR_FS_CP_EINVAL 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_HTTP2_INVALID_SESSION

ERR_HTTP2_INVALID_SESSION 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_HTTP2_NO_SOCKET_MANIPULATION

ERR_HTTP2_NO_SOCKET_MANIPULATION 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_HTTP2_OUT_OF_STREAMS

ERR_HTTP2_OUT_OF_STREAMS 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_HTTP2_STREAM_CANCEL

ERR_HTTP2_STREAM_CANCEL 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_MANIFEST_ASSERT_INTEGRITY

ERR_MANIFEST_ASSERT_INTEGRITY 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_NO_TYPESCRIPT

ERR_NO_TYPESCRIPT 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_OPERATION_FAILED

ERR_OPERATION_FAILED 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_OPTIONS_BEFORE_BOOTSTRAPPING

ERR_OPTIONS_BEFORE_BOOTSTRAPPING 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

ERR_PACKAGE_MAP_EXTERNAL_FILE

ERR_PACKAGE_MAP_EXTERNAL_FILE 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

Page not found

Netlify 공식 원문에 표시된 Page not found 항목의 문구를 확인하는 문서입니다.

참고 자료

Node.js API Documentation (새 창에서 열림)

Node.js · 공식 자료 · 확인 범위: javascript-runtime, node-api, runtime-configuration · 확인일: 2026-07-27