데브허브 | DEVHUB | crypto.hash is not a function 에러 대처하기. (리액트, 뷰 개발자 필수시청, 안보면 후회함)crypto.hash is not a function 에러 대처하기. (리액트, 뷰 개발자 필수시청, 안보면 후회함)
- Vite 기반 React/Vue 프로젝트에서
npm run dev 시 crypto.hash is not a function 에러가 발생할 수 있습니다. 💥
- 이 에러는 2025년 6월 24일 Vite 7.0 버전 업데이트로 인해 Node.js 최소 버전 요구사항이 상향되었기 때문입니다. ⬆️
- Vite 7.0은 Node.js 18 버전 지원을 완전히 종료했으며, 최소 Node.js 20.19 또는 22.12 버전 이상이 필요합니다. 🚫
- 현재 Node.js 버전이 20.11.0과 같이 최소 요구사항에 미치지 못할 경우 에러가 발생합니다. 📉
- 해결책은 Node.js 버전을 Vite 7.0의 최소 요구사항인 22.12 버전 이상으로 업그레이드하는 것입니다. 🚀
n 패키지 관리자를 사용하는 경우 sudo n LTS 명령어를 통해 최신 LTS 버전(예: 22.17.0)으로 쉽게 업그레이드할 수 있습니다. 🛠️
- 사용자들은 각자의 OS 환경에 맞는 Node.js 업그레이드 방법을 찾아 적용해야 합니다. 🌐
- Node.js 버전 업그레이드 후
npm run dev 명령을 다시 실행하면 프로젝트가 정상적으로 구동됩니다. ✅
- 앞으로 생성될 신규 프로젝트는 기본적으로 Vite 7.0이 적용되므로, Node.js 버전을 미리 확인하고 대처하는 것이 중요합니다. 💡