인프런 커뮤니티 질문&답변

안녕하세요 이정환입니다.

2025년 7월 23일 기준 현재 Node.js의 LTS 버전은 22.x 버전입니다. 과거의 LTS 버전인 20.x 버전을 사용하고 계시다면 오류가 발생할 수 있으니 Node.js 버전을 업그레이드 하시면 문제가 해결될 것 같습니다.

예상되는 문제의 원인은 최근 설치하신 Vite 버전이 7버전으로 생각되며, Vite 버전과 Node 버전의 호환성 문제로 발생한거 같습니다.

Vite 7 버전부터는 Node.js 버전에 대한 명확한 요구사항이 있습니다!

• Vite 7 이상 버전은 반드시 Node.js 20.19 이상 또는 22.12 이상을 요구합니다.

   

이로 인해 현재 사용 중인 Node.js 버전이 Vite 7이 요구하는 최소 버전에 미치지 못하면, 위와 같은 에러(crypto.hash is not a function)가 발생할 수 있습니다.

해결 방법으로는 node 버전을 올리거나 vite 버전을 낮추거나 해야 될 거 같습니다

자세한 내용은 공식 문서에서 확인하실 수 있습니다.

https://vite.dev/blog/announcing-vite7

안녕하세요, 인프런 AI 인턴입니다. 부드러운 족제비님.

Vite로 리액트 프로젝트를 실행하려고 할 때 발생하는 오류에 대해 설명해드리겠습니다. 주로 TypeError: crypto.hash is not a function라는 오류는 Node.js 버전이 잘못되었거나 필요한 특정 기능이 활성화되지 않은 경우에 나타날 수 있습니다.

에러의 원인과 해결 방안

1. Node.js 버전 문제:

   • 현재 사용하시는 Node.js의 버전(v20.11.1)이 최신 버전이긴 하지만, 경우에 따라 특정 모듈의 업데이트가 충분히 이루어지지 않을 수 있습니다. 특히 crypto 모듈은 Node.js의 기본 내장 모듈로, 사용하고 있는 버전이 간혹 문제가 될 수 있으니 약간의 버전 변경을 고려해 보세요. v20.x.x의 안정된 릴리즈를 사용해 보세요. 다른 버전(예: v18.x.x 또는 v16.x.x)을 설치해보기도 권장됩니다.
     

2. crypto 모듈 확인:

   • crypto 모듈은 예전 버전의 Node.js에서는 일부 기능이 비활성화되어 있을 수 있습니다. 따라서 require('crypto')에서 필요한 기능을 명시적으로 불러오고 있는지를 확인하세요. 필요하다면 require('crypto').createHash('algorithm')와 같은 형태로 호출해 보세요.
     

3. dependencies 확인:

   • 사용하고 있는 npm 패키지들이 최신의 Node.js 버전과 호환되는지 확인해 주세요. package.json 파일에서 관련된 모듈 버전을 최신으로 업그레이드하거나 필요한 경우 이전 버전으로 다운그레이드 해보세요.
     

4. Config 파일 확인:

   • vite.config.js 혹은 vite.config.ts 파일 내에서의 설정 문제가 있는지 확인해 보세요.
     

추가적으로 도움이 될만한 자료

• Vite 공식 문서: Vite 관련 문서
  
• Node.js 공식 문서: Node.js Crypto 모듈
  

위 방법들이 도움이 되지 않는다면, 구체적인 오류 메시지와 로그를 참고하여 추가적인 문제 해결을 시도하시는 것도 좋습니다.

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다.
현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏
추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.