Node.js — 관련 콘텐츠 36건

npx 사용법 | 설치 없이 패키지 명령을 바로 실행합니다

npx는 로컬에 있으면 그 명령을, 없으면 npm 캐시에 받아 실행합니다. 설치 확인 질문을 건너뛰는 --yes, npm exec와 옵션 순서 차이를 npm 공식 문서로 확인했습니다.

npm 업데이트 | 맥은 명령 하나, 윈도우는 PATH 순서까지 봅니다

npm 업데이트 명령은 npm install -g npm@latest. 윈도우에서 npm -v가 그대로면 PATH에서 nodejs 폴더가 사용자 전역 폴더보다 앞에 있는 상황입니다. 근거는 npm 공식 문서입니다.

Node.js LTS 버전 | 운영은 24, 10월 28일부터 26도 LTS입니다

Node.js 20 지원 종료 뒤 운영 서버 버전 고르기. 24는 10월 20일 Maintenance LTS, 26은 10월 28일 Active LTS 예정, 22는 2027년 4월 30일 종료. Node.js 릴리스 일정과 Vercel 지원 버전으로 정리했습니다.

동기 require, ESM, 노드 버전 | 패키지는 있는데 require만 막히면?

ERR_REQUIRE_ESM은 패키지는 있는데 require가 ES 모듈을 열지 못할 때 나는 코드입니다. node 버전과 process.features.require_module을 보고, 최상위 await면 ERR_REQUIRE_ASYNC_MODULE로 import를 씁니다. exports 서브패스 거절, 모듈 없음과는 다릅니다. Node.js, ESM, CI, 한국 1인 개발. 2026년 10월 문서.

엣지 런타임, 노드 모듈 미지원, 미들웨어 | 배포 로그만 모듈을 거절하면?

엣지 런타임은 fs, crypto, pg 같은 노드 모듈을 열지 못합니다. 로그에 찍힌 모듈을 미들웨어 임포트에서 빼고, 데이터베이스는 노드 라우트로 옮깁니다. 해시는 웹 크립토로 바꿉니다. 개발 서버가 조용해도 배포 번들은 거절할 수 있습니다. Next.js, 미들웨어, 버셀, 한국 1인 개발. 2026년 10월 문서.

ERR_PACKAGE_PATH_NOT_EXPORTED, 서브패스, exports | 패키지는 있는데 깊은 경로만 막히면?

ERR_PACKAGE_PATH_NOT_EXPORTED는 패키지는 있는데 exports에 없는 서브패스를 불러 노드가 거절할 때 나는 코드입니다. 공개 입구로 바꾸거나, 내 패키지면 그 경로를 exports에 적습니다. node_modules 수정은 다음 설치에서 돌아옵니다. Node.js, package.json, 빌드, 한국 1인 개발. 2026년 10월 문서.

ERR_OSSL_EVP_UNSUPPORTED, 디지털 봉투, 레거시 프로바이더 | 노드만 올렸는데 빌드 해시가 죽으면?

ERR_OSSL_EVP_UNSUPPORTED는 노드 17 이후 OpenSSL 3이 MD4를 막아 웹팩 빌드 해시가 죽을 때 나는 코드입니다. 당장은 NODE_OPTIONS에 openssl-legacy-provider를 넣고, 남기려면 hashFunction을 sha256으로 바꾸거나 웹팩 5로 올립니다. dlopen ABI 실패와는 다른 줄입니다. Node.js, webpack, CI, 한국 맥 개발. 2026년 10월 문서.

dlopen 실패, 노드 버전, 네이티브 모듈 | 노드만 올리면 모듈이 안 열리면?

노드 메이저만 올리면 NODE_MODULE_VERSION이 다른 .node를 process.dlopen이 거절합니다. process.versions.modules로 요구 숫자를 읽고 그 패키지를 npm rebuild합니다. 자바스크립트 경로 없음, exec format error, 권한 모델의 애드온 거절과 줄을 가릅니다. Node.js, sharp, CI, 한국 맥 개발. 2026년 9월 문서.

ECONNREFUSED, localhost, 도커 네트워크 | 컨테이너 안에서 5432가 거절되면?

컨테이너 안에서 localhost:5432가 거절되면 그 주소는 호스트가 아니라 컨테이너입니다. compose는 서비스 이름, 호스트 디비는 host.docker.internal, 리눅스는 extra_hosts를 맞춥니다. ECONNREFUSED, Docker, PostgreSQL 5432, DATABASE_URL, Node.js, 넥스트, Prisma, 1인 개발자 맥 데스크톱 기준. 2026년 9월 Node.js·도커 공식 문서.

tsconfig paths, alias, 모듈 해석 | @/ 가 런타임에서만 깨지면?

넥스트는 되는데 node 스크립트만 @/ 별칭을 못 찾으면 tsconfig paths가 런타임 경로를 안 바꿉니다. TypeScript paths, Next.js 번들러, Node.js 타입 스트리핑, package.json imports, 모듈 해석, 1인 개발자 크론과 깃허브 액션 기준. 2026년 9월 TypeScript, Node, Next 공식 문서.

headers was already sent, API 라우트, res.end | JSON을 두 번 쓰면 왜 500이 되나?

페이지 API에서 JSON을 두 번 쓰면 노드가 헤더를 이미 보냈다고 하고 화면은 500이 된다. res.json 다음 return, headersSent, 앱 라우트 Response 반환을 나눈다. 카카오 콜백과 토스 웹훅에서 200 뒤 오류 칸을 본다. Next.js, Node.js, API, 웹훅, 백엔드, 개발자 기준. 2026년 9월 Node.js, Next.js 공식 문서.

429 Too Many Requests, Retry-After, 백오프 | API 한 번에 몰리면 어디를 줄일까?

429는 인증 실패가 아니라 짧은 시간에 호출이 많아 서버가 기다리라고 한 응답이다. Retry-After 초와 HTTP 날짜를 읽고, 헤더가 없으면 지수 백오프에 지터를 넣는다. 크론·웹훅·액션이 같은 키를 쓰면 동시 호출과 배치부터 줄인다. 개발자, API, 백엔드, Node.js, Next.js, 깃허브 기준. 2026년 9월 MDN·RFC 6585·깃허브 REST 문서.

ETIMEDOUT, fetch failed, undici | 배포 함수에서만 타임아웃이면?

배포 함수에서만 fetch가 끊기면 로컬 회선이 빠른 게 아니라 함수 대기 한도와 아웃바운드 경로가 다르다. ETIMEDOUT과 undici fetch failed의 cause.code를 남기고, maxDuration·AbortSignal·리전을 맞춘다. 개발자, Node.js, 버셀, Next.js, 백엔드, API 기준. 2026년 8월 Node.js·MDN·버셀 문서.

ELIFECYCLE, npm ERR, 빌드 스크립트 | 로컬은 되고 CI만 빨간 줄이면?

ELIFECYCLE은 npm이 감싼 실패다. 실제 원인은 위 도구 로그와 종료 숫자다. 로컬은 되고 통합 환경만 실패하면 노드 버전, 잠금 파일 설치, 환경변수, 맥과 리눅스 대소문자부터 맞춘다. 개발자, npm, 깃허브 액션, Next.js, Node.js, 데브옵스 기준. 2026년 8월 npm과 깃허브 공식 문서 기준.

Heap out of memory, Node.js 메모리, --max-old-space-size | 빌드가 137로 죽으면?

빌드 종료 코드 137은 문법 오류가 아니라 커널이 프로세스를 죽인 신호다. 힙 메시지와 러너 메모리를 같이 보고, 원본 이미지를 줄인 뒤 공식 힙 상한만 올린다. 한국 1인 개발자, Node.js, Next.js, 깃허브 액션, 도커, CI, 빌드 기준. 2026년 8월 Node.js와 Next.js, 깃허브 공식 문서.

ENOENT, no such file, 경로 오타 | 스크립트 cwd가 루트가 아니면?

ENOENT는 그 경로 문자열이 지금 작업 폴더 기준으로 디스크에 없을 때 난다. npm 스크립트는 package.json 위치, 크론은 홈이 cwd다. __dirname으로 고정 파일을 열고 WorkingDirectory를 넣는다. 개발자, Node.js, npm, 깃허브 액션, 도커, 크론 기준. 2026년 8월 Node.js·npm·깃허브 문서.

Cannot find module, 모듈을 찾을 수 없음, node_modules | 지워도 같은 줄이 뜨면 뭐부터 볼까?

Cannot find module은 패키지가 없어서가 아니라 노드가 이름을 찾을 폴더를 지나쳤거나 대소문자가 달라서 난다. node_modules를 지워도 같으면 cwd와 require 이름부터 본다. 크론, 깃허브 액션, 맥과 리눅스 CI, npm ci. 개발자, Node.js, npm, Next.js, 백엔드 기준. 2026년 8월 Node.js·npm 공식 문서.

Fastify, Hono, Express, API 라우팅 | Node 백엔드 프레임워크는 언제 갈라질까?

Fastify·Hono·Express를 런타임·JSON 스키마·플러그인·엣지 배포·팀 이전 비용 기준으로 표 비교한다. Node API·REST·TypeScript·미들웨어·OpenAPI·BFF 선택, tRPC·Elysia와의 경계, 카나리 이전 체크리스트와 공식 문서 출처를 개발자·백엔드 관점에서 정리한 vs-comparison 가이드.

Docker 멀티스테이지 빌드 실전 - Node.js·Next.js 이미지 크기 줄이는 체크리스트

도커 멀티스테이지 빌드(Docker multi-stage build)로 Node.js Express·API 서버와 Next.js standalone 이미지를 최적화하는 실전 가이드. 단일 스테이지와 멀티스테이지 구조 차이, 레이어 캐시 최적화(package.json 먼저 복사), .dockerignore 설정, non-root 사용자 실행, 이미지 크기 확인 명령어, 자주 막히는 alpine 호환 문제·환경변수 주입까지 체크리스트 형태로 정리. 백엔드·풀스택·데브옵스 개발자를 위한 도커 배포 최적화 실무 가이드.

Meilisearch 실전 튜토리얼 — Docker 설치부터 Node.js SDK·필터·랭킹·Next.js 연동까지

메이리서치(Meilisearch) 오픈소스 검색 엔진 실전 튜토리얼. Docker 로컬 설치, 인덱스·문서 업로드, Node.js SDK 동기화, 필터·정렬·동의어·랭킹 규칙, Next.js App Router API 프록시, 검색 전용 API 키 분리와 프로덕션 배포 체크리스트까지. 일래스틱서치 대신 가벼운 전문 검색이 필요한 백엔드·프론트엔드 개발자를 위한 단계별 가이드.