node.js21 Bun npm 패키지 호환 안 될 때｜원인별 3단계 해결 가이드 환경Windows·macOS·Linux증상모듈·바이너리 실행 실패원인설치 스크립트·API 차이해결재설치 후 Node 전환바로가기Bun 호환성 문서 bun run 직후 Cannot find module '패키지명', ModuleNotFound, error: script "start" exited with code 1이 나온다면 설치 성공 여부부터 다시 봐야 한다.특히 네이티브 바이너리를 포함한 npm 패키지는 설치는 끝났는데 실행 파일이 생성되지 않는 현상도 생긴다.아래 절차는 2026년 8월 31일 기준 최신 Bun 문서를 토대로 Windows·macOS·Linux에서 공통으로 적용할 수 있게 구성했다.먼저 bun --version과 기존 Node.js 실행 결과를 함께 기록하면 런타임 문제인지 패키지 .. 2026. 9. 1. 서비스용 API 가격 비교｜영화·게임·여행·검색 트렌드 연동법 항목내용환경Node.js 22·fetch증상401 또는 429 응답원인 한 줄키·쿼터·상업권한 불일치해결 한 줄용도별 API와 요금제 선택바로가기TMDB 공식 문서 영화·게임·여행 검색 기능을 붙였는데 HTTP 401 Unauthorized가 나오거나, 테스트 중 갑자기 HTTP 429 Too Many Requests로 막히는 경우가 있다.키를 고쳐도 해결되지 않는다면 인증 오류가 아니라 무료 쿼터 또는 상업 이용 범위를 넘었을 가능성이 크다.증상｜무료 API인데 서비스에서 호출이 막힌다 무료라는 말은 데이터 재판매, 광고 수익, 제휴 링크 삽입까지 모두 허용한다는 뜻이 아니다.특히 영화 다시보기 버튼이나 게임 구매 링크를 만들 때는 데이터 사용권과 제휴 수익 권한을 따로 확인해야 한다.HTTP 401.. 2026. 8. 31. Node.js 요청 실패 원인, fetch failed 코드별 확인 순서 항목내용환경Node.js 18 이상증상TypeError: fetch failed원인DNS·연결·TLS 실패해결cause 코드부터 확인바로가기Node.js fetch 문서 TypeError: fetch failed만 출력되고 요청이 끝난다면 바깥쪽 메시지만 보고 원인을 판단하기 어렵다.실제 단서는 예외의 cause.code와 cause.message에 들어 있다.증상부터 재현하고 실행 환경 확인하기 아래 코드는 Node.js 18 이상에서 별도 패키지 없이 실행할 수 있다. 내장 fetch()는 Node.js 18.0.0부터 플래그 없이 제공됐고 21.0.0부터 안정화됐다.console.log({ node: process.version, undici: process.versions.undici, p.. 2026. 8. 30. CORS 사전 요청이 실패할 때｜OPTIONS 오류 4단계 해결법 항목내용환경Node 22·Express 5증상OPTIONS 뒤 요청 중단원인허용 응답 헤더 불일치해결서버 CORS 설정 수정바로가기MDN CORS 문서 브라우저 콘솔에 아래 메시지가 나오고 Network 탭에서 OPTIONS만 실패한다면 실제 POST나 DELETE 요청은 아직 전송되지 않은 상태다.이 글의 예시는 Ubuntu 24.04, Node.js 22, Express 5.2.1, cors 2.8.6 구성을 기준으로 한다.Access to fetch at 'https://api.example.com/users' from origin 'https://app.example.com' has been blocked by CORS policy: Response to preflight request doesn.. 2026. 8. 30. package-lock.json 충돌 해결｜안전하게 병합하는 순서 항목내용환경Git 2.x·npm 7~12증상lock 파일 병합 충돌원인 한 줄양쪽 브랜치의 의존성 변경해결 한 줄package.json 병합 후 재생성바로가기npm 공식 문서 git merge 또는 git rebase 직후 CONFLICT (content): Merge conflict in package-lock.json이 표시되고 작업이 멈췄다면 lock 파일의 충돌을 먼저 정리해야 한다.파일 안에는 다음과 같은 Git 충돌 표식이 남아 있을 수 있다.>>>>>> feature충돌 상태와 변경 범위 확인 먼저 package.json도 함께 충돌했는지 확인한다.package-lock.json만 보고 한쪽 내용을 선택하면 새로 추가된 직접 의존성이 빠지거나, 반대로 삭제된 패키지가 잠금 트리에 남을 수 .. 2026. 8. 30. npm 의존성 충돌 ERESOLVE 오류 해결 순서 항목내용환경모든 OS·npm 7 이상증상ERESOLVE 설치 중단원인요구 버전 범위 충돌해결호환 버전으로 통일바로가기npm install 문서 npm install 도중 아래처럼 npm ERR! code ERESOLVE와 Could not resolve dependency가 나오면 패키지 다운로드 문제가 아니다.현재 프로젝트의 패키지 버전과 새 패키지가 요구하는 peer dependency 범위를 동시에 만족하지 못해 설치가 중단된 것이다.npm ERR! code ERESOLVEnpm ERR! ERESOLVE unable to resolve dependency treenpm ERR! Could not resolve dependency:npm ERR! peer react@"^17.0.0" from exam.. 2026. 8. 30. 이전 1 2 3 4 다음
