Webpack 빌드 에러 'ERR_OSSL_EVP_UNSUPPORTED' 해결

 

ParaView Glance빌드 중에 생긴 오류다.

 

https://github.com/Kitware/glance

GitHub - Kitware/glance: Kitware Glance is an open-source web application developed at Kitware for visualizing volumetric images

 

여기서 아래처럼 하라고 했는데, 오류가 생겼다. 

$ git clone https://github.com/Kitware/glance.git
$ cd glance/
$ npm install
$ npm run build
$ npm run dev

 오류 발생 부분

오류가 생긴 부분은 아래 두군데다.

$ npm run build
$ npm run dev

 

 오류 발생 모습

npm run build

> glance@0.0.0-semantically-release build > webpack --config build/webpack.dev.config.js [webpack-cli] Error: error:0308010C:digital envelope routines::unsupported at new Hash (node:internal/crypto/hash:68:19) at Object.createHash (node:crypto:138:10) at BulkUpdateDecorator.hashFactory (/Users/sark/dev/paraview/glance/node_modules/webpack/lib/util/createHash.js:155:18) at BulkUpdateDecorator.digest (/Users/sark/dev/paraview/glance/node_modules/webpack/lib/util/createHash.js:80:21) at /Users/sark/dev/paraview/glance/node_modules/webpack/lib/DefinePlugin.js:595:38 at _next26 (eval at create (/Users/sark/dev/paraview/glance/node_modules/tapable/lib/HookCodeFactory.js:19:10), <anonymous>:44:1) at _next4 (eval at create (/Users/sark/dev/paraview/glance/node_modules/tapable/lib/HookCodeFactory.js:19:10), <anonymous>:97:1) at Hook.eval [as call] (eval at create (/Users/sark/dev/paraview/glance/node_modules/tapable/lib/HookCodeFactory.js:19:10), <anonymous>:109:1) at Hook.CALL_DELEGATE [as _call] (/Users/sark/dev/paraview/glance/node_modules/tapable/lib/Hook.js:14:14) at Compiler.newCompilation (/Users/sark/dev/paraview/glance/node_modules/webpack/lib/Compiler.js:1053:26) { opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ], library: 'digital envelope routines', reason: 'unsupported', code: 'ERR_OSSL_EVP_UNSUPPORTED' }

 

npm run dev

> glance@0.0.0-semantically-release dev > webpack-dev-server --config build/webpack.dev.config.js node:internal/crypto/hash:68 this[kHandle] = new _Hash(algorithm, xofLen); ^ Error: error:0308010C:digital envelope routines::unsupported at new Hash (node:internal/crypto/hash:68:19) at Object.createHash (node:crypto:138:10) at BulkUpdateDecorator.hashFactory (/Users/sark/dev/paraview/glance/node_modules/webpack/lib/util/createHash.js:155:18) at BulkUpdateDecorator.digest (/Users/sark/dev/paraview/glance/node_modules/webpack/lib/util/createHash.js:80:21) at /Users/sark/dev/paraview/glance/node_modules/webpack/lib/DefinePlugin.js:595:38 at _next28 (eval at create (/Users/sark/dev/paraview/glance/node_modules/tapable/lib/HookCodeFactory.js:19:10), <anonymous>:40:1) at _next6 (eval at create (/Users/sark/dev/paraview/glance/node_modules/tapable/lib/HookCodeFactory.js:19:10), <anonymous>:97:1) at Hook.eval [as call] (eval at create (/Users/sark/dev/paraview/glance/node_modules/tapable/lib/HookCodeFactory.js:19:10), <anonymous>:113:1) at Hook.CALL_DELEGATE [as _call] (/Users/sark/dev/paraview/glance/node_modules/tapable/lib/Hook.js:14:14) at Compiler.newCompilation (/Users/sark/dev/paraview/glance/node_modules/webpack/lib/Compiler.js:1053:26) { opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ], library: 'digital envelope routines', reason: 'unsupported', code: 'ERR_OSSL_EVP_UNSUPPORTED' }

 

 오류 발생 이유

이유는 내 Node버전이 이 프로젝트와 맞지 않아서다. 내가 사용하고 있는 버전은 v20.8.1이었는데, 대략 이 프로젝트는 17미만의 버전을 사용하는 것이 적절해보인다.

이 에러는 최신 버전의 Node.js(특히 Node.js 17 이상)에서 발생하는 것으로 보이며, OpenSSL 3.0과 관련된 변경으로 인해 특정 암호화 알고리즘이 기본적으로 비활성화된 것이 원인일 가능성이 높다. Node.js 17 이상에서는 기본적으로 몇몇 암호화 알고리즘이 비활성화되어 있어, 이와 관련된 기능을 사용하는 Webpack 또는 다른 패키지에서 오류가 발생할 수 있다.

 

 해결책

아래의 해결책 중 하나를 시도하여 문제를 해결할 수 있다. 내 경우는 Node 버전 변경도 귀찮고, 최대한 빨리 실행시키고 싶어, 2번의 패키지 파일을 건드리는 방식으로 해결했다. 프로젝트의 요구 사항과 환경에 따라 적합한 방법을 선택하시길. 3, 4번은 추측성이라 참고만 하시길 바란다.

1. Node.js 버전 다운그레이드:
Node.js의 이전 버전(예: 16.x)으로 다운그레이드. 이전 버전에서는 해당 문제가 발생하지 않을 수 있다.

2. 환경 변수 설정:
Node.js에서 OpenSSL 3.0과 관련된 기능을 다시 활성화하려면 환경 변수 NODE_OPTIONS를 설정할 수 있다. 터미널에서 다음 명령어를 실행하거나, 해당 환경 변수를 프로젝트의 npm 스크립트에 추가한다:

export NODE_OPTIONS=--openssl-legacy-provider

또는 package.json의 스크립트 섹션에 다음과 같이 NODE_OPTIONS=--openssl-legacy-provider 부분을 추가할 수 있다:

"scripts": {
"build": "NODE_OPTIONS=--openssl-legacy-provider webpack --config build/webpack.dev.config.js",
"dev": "NODE_OPTIONS=--openssl-legacy-provider webpack-dev-server --config build/webpack.dev.config.js",
}

3. Node.js 버전 업데이트:
해당 문제가 수정된 Node.js의 새 버전이 있다면, Node.js를 최신 버전으로 업데이트한다. 

4. Webpack 및 관련 의존성 업데이트:
Webpack과 관련된 의존성을 최신 버전으로 업데이트한다.

뭐 하나 해결하는데, 항상 애먹는 게 아직 내공을 한참 더 쌓아야 할듯 싶다. 화이팅!