[npm] NPM 실행 시 세그멘테이션 오류(Segmentation Fault) 해결 방법

1. 문제 상황

npm run dev 명령어 실행 시 세그멘테이션 오류가 발생하며 실행이 중단됨.

npm run dev

> fe@0.1.0 dev
> next dev --turbopack

/c/Program Files/nodejs/npm: line 65:   677 Segmentation fault      "$NODE_EXE" "$NPM_CLI_JS" "$@"

추가 오류 메시지

• Segmentation fault (3221225477 오류 코드)
  • Node.js 실행 중 메모리 접근 오류로 인해 충돌 발생
  • 보통 손상된 npm 패키지, 권한 문제, 또는 OneDrive 경로 문제에서 발생
• 파일 삭제 실패 (EBUSY, EPERM 오류)
  • 특정 폴더(node_modules/puppeteer, node_modules/next 등)를 삭제하지 못함
  • OneDrive 내 경로에서 npm 실행 시 발생 가능
  • 특정 프로세스(예: Puppeteer)가 실행 중일 가능성 있음

 

 

2. 문제 해결을 위한 시도 (실패한 방법들)

아래 방법들을 시도했지만 해결되지 않았다.

1. node_modules 및 package-lock.json 삭제 후 npm install 실행
2. npm cache clean --force 명령어 실행
3. Node.js 및 npm 최신 버전으로 업데이트 후 재시도
4. 환경변수에서 예전 Node.js 경로를 제거하고 올바른 경로로 수정

→ 오류 해결 불가, 오히려 더 많은 오류가 발생함

 

3. 원인 분석

❗ OneDrive 경로에서 npm 실행 시 문제 발생

• 현재 프로젝트가 OneDrive 폴더 (C:\Users\moho0\OneDrive\문서\바탕 화면)에 위치
• OneDrive 경로에서는 npm이 정상적으로 동작하지 않는 경우가 많다고 한다.
• 파일 동기화 문제로 인해 node_modules 폴더가 일부 손상될 가능성도 있다고한다.

 

4. 해결 방법

✅ OneDrive가 아닌 로컬 디렉토리로 프로젝트 이동

1. 프로젝트 폴더를 다른 경로로 이동
   • 예: C:\dev\minutemind로 이동
2. 기존의 node_modules 및 package-lock.json 삭제 후 npm 재설치

# PowerShell에서 실행
Remove-Item -Recurse -Force node_modules
Remove-Item -Force package-lock.json

# npm 캐시 삭제
npm cache clean --force

# 패키지 재설치
npm install

# 개발 서버 실행
npm run dev

1. 정상 동작 여부 확인
   • npm run dev 명령어 실행 시 오류 없이 서버가 정상적으로 실행되는지 확인

 

 

5. 결론 및 정리

📌 핵심 정리

• OneDrive 경로에서 npm을 실행할 경우 오류가 발생할 수 있다.
• 프로젝트 폴더를 로컬 드라이브(C:\dev\ 등)로 이동하면 해결 가능!
• npm 캐시 정리 및 패키지 재설치도 필요하다.

🛠 추가 팁

• Node.js 환경이 꼬였을 경우 nvm을 활용하여 Node.js 버전을 재설치하는 것도 고려
• 권한 문제로 인해 삭제가 안 되는 경우, 관리자 권한으로 PowerShell 실행 후 삭제