패키지 실행시 ERR_OSSL_EVP_UNSUPPORTED 발생

집 PC 환경을 윈도우를 재설치를 하면서 재구성하게 되었는데, Node.js 가 v20.x 가 설치가 되었다.

기존 프로젝트를 npm run dev 를 실행하였는데 "ERR_OSSL_EVP_UNSUPPORTED" 오류가 발생하였고, 그 해결책을 블로그에 기록해본다.

 

1. package.json 에 시작 커맨드에 "--openssl-legacy-provider" 를 추가한다.

해당 오류는 Node.js v17.x 부터 강화된 보안 옵션으로 인해 발생한다고 한다. npm start script 쪽에 "--openssl-legacy-provider" 를 추가해서 회피해줄 수 있다. 다만 이렇게 할 경우 다른 팀원이 pull를 했을때도 적용되니 2. 번을 추천한다.

 

2. Node.js 버전을 < v17 로 내린다.

16 버전대 LTS v16.17.1 를 설치해주고 사용하도록 하여 해결한다.

nvm install 16.17.1
nvm use 16.17.1

 

Windows 에서 nvm 커맨드가 안먹힌다면, 아래 링크로 가서 nvm 을 설치하면 된다.

https://github.com/coreybutler/nvm-windows/releases