[NNN]_트러블 슈팅 1 error:0308010c:digital envelope routines::unsupported

상황

npm run dev 를 통해 next 를 실행하면서 마주친 오류입니다.

 

문제원인분석 1

마지막 줄에서 볼 수 있듯이 현재 설치되어 있는 노드버전은 18.16.0 버전이고, 제가 필요로 하는 노드버전은 16버전이기 때문에 다운그레이드를 해주어야 한다고 생각했습니다.

 

해결방법

nvm 을 이용해서 설치되어 있는 노드버전을 쉽게 다운그레이드해줄 수 있습니다.

 

 

nvm 이란?

nvm 은 Node Version Manager 의 줄임말로 뜻 그대로 Node.js 의 버전을 관리하는 도구입니다.

이를 이용해 언제든지 사용할 버전을 쉽게 전환할 수 있습니다.

우선 nvm -v 을 통해 nvm 이 설치되어 있는지 확인해보고, 설치되어 있지 않다면, 아래 링크로 설치할 수 있습니다.

 

설치방법

https://github.com/coreybutler/nvm-windows/?tab=readme-ov-file

GitHub - coreybutler/nvm-windows: A node.js version management utility for Windows. Ironically written in Go.

표시된 파란색 버튼을 누르면,

exe 파일을 다운받아 바로 설치할 수 있습니다.

 

문제의 문제발생!

nvm 을 설치받았다면, 

nvm install 설치할 버전

명령어를 통해 노드버전을 수정할 수 있는데, 다음과 같이 경로에러가 발생했습니다.

이 경우 nvm 의 설치 경로 설정이 잘못되어 프로그램이 설치할 위치를 찾지 못하고 있는 것이기 때문에 명령어를 통해 수동으로 경로 설정을 해주어야 합니다.

 

nvm root "파일 위치"

위 명령어를 명령 프롬프트에서 직접 경로를 설정해주었습니다.

위 오류의 경우 PC 사용자 이름에 특수기호가 들어있거나, 공백이 있는 경우에 발생하는 문제로 수동으로 경로 설정을 다시 해주면, 정상적으로 node.js 의 version 설치가 가능합니다.

 

문제의 문제해결!

 

문제원인분석 2

다운그레이드해도 해결이 되지 않았고, 좀 더 자세히 알아보았더니 react 와 Next 의 버전이 서로 호환이 되지 않으면서 충돌하는 문제였습니다.

 

해결

둘 다 최신 버전으로 업데이트해주었고, 깔끔하게 해결되었습니다.

package.json

{
  "name": "react-nodebird-front",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "dev": "next",
    "build": "next build"
  },
  "author": "yngjnhyk",
  "license": "ISC",
  "dependencies": {
    "next": "^14.1.0",
    "react": "^18.2.0",
    "react-dom": "^18.2.0"
  }
}