Node.jsのERR_OSSL_EVP_UNSUPPORTEDの原因と直し方
crypto.createHash('md4') を実行したときに Error: error:0308010C:digital envelope routines::unsupported(code: 'ERR_OSSL_EVP_UNSUPPORTED')が出て止まるのは、Node.js に入っている OpenSSL 3 が、md4 を既定では使えないようにしているからです。自分のコードなら sha256 などに置き換え、webpack 4 のビルドで出ているなら、Node.js 18 以降で webpack を 4.47.0 以降に上げるか、5.61.0 以降の webpack 5 に移ると、エラーは消えます。
自分で md4 を呼んでいなくても、古い webpack 4 のプロジェクトを Node.js 17 以降でビルドしたときに、同じエラーが出ます。私は Node.js の3つのバージョンで、md4 を使う短いスクリプトと webpack 4 のビルドの両方でエラーを起こし、出たメッセージと、直したあとに消えることを確かめました。
検証環境は Ubuntu 24.04(x86_64)で、Node.js 16.20.2(OpenSSL 1.1.1v)、22.23.4(OpenSSL 3.5.9)、24.22.1(OpenSSL 3.5.9)を使いました。16.20.2 は nodejs.org で配布されている Linux 用のバイナリです。npm のパッケージは webpack 4.46.0・4.47.0(webpack-cli 4.10.0)と webpack 5.112.2(webpack-cli 5.1.4)です。Windows と macOS、Node.js 17〜21 と 23 系、Create React App や Vue CLI などの webpack を中に持つツール、md4 以外の古い暗号の方式で出る同じエラーは試していません。
md4 でハッシュを作ると出るエラー
文字列 hello の md4 のハッシュを表示するだけの hash.js を用意しました。
const crypto = require('node:crypto');
console.log(crypto.createHash('md4').update('hello').digest('hex'));
Node.js 22.23.4 で実行すると、次のように出て止まりました(終了コードは1。パスは例示用の値に置き換えています)。
$ node hash.js
node:internal/crypto/hash:101
this[kHandle] = new _Hash(algorithm, xofLen, algorithmId, getHashCache());
^
Error: error:0308010C:digital envelope routines::unsupported
at new Hash (node:internal/crypto/hash:101:19)
at Object.createHash (node:crypto:139:10)
at Object.<anonymous> (/path/to/app/hash.js:2:20)
at Module._compile (node:internal/modules/cjs/loader:1781:14)
at Object..js (node:internal/modules/cjs/loader:1913:10)
at Module.load (node:internal/modules/cjs/loader:1505:32)
at Function._load (node:internal/modules/cjs/loader:1309:12)
at wrapModuleLoad (node:internal/modules/cjs/loader:254:19)
at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:171:5)
at node:internal/main/run_main_module:36:49 {
opensslErrorStack: [
'error:03000086:digital envelope routines::initialization error',
'error:0308010C:digital envelope routines::unsupported'
],
library: 'digital envelope routines',
reason: 'unsupported',
code: 'ERR_OSSL_EVP_UNSUPPORTED'
}
Node.js v22.23.4
Error: で始まる行には、ERR_OSSL_EVP_UNSUPPORTED という名前が出てきません。エラー名は、最後のほうの code: の行にあります。digital envelope routines は、OpenSSL の中でハッシュや暗号をまとめて扱う部分(EVP)の名前です。その部分が「unsupported(対応していない)」と返した、という意味になります。スタックの2行目に createHash があるので、createHash('md4') を呼んだところで止まったことが分かります。
Node.js 24.22.1 でも、Error: error:0308010C:digital envelope routines::unsupported と code: 'ERR_OSSL_EVP_UNSUPPORTED' が出て、終了コードは1でした。内部の行番号やスタックの表示のほかに違ったのは、opensslErrorStack に initialization error の1行だけが入っていた点です。
try〜catch でエラーを捕まえると、err.code と err.message は次のようになりました(Node.js 22.23.4 と 24.22.1 で同じ)。エラーを見分けたいときは、code を比べます。
ERR_OSSL_EVP_UNSUPPORTED
error:0308010C:digital envelope routines::unsupported
原因は OpenSSL 3 で md4 が既定から外れたこと
同じ hash.js を Node.js 16.20.2 で実行すると、エラーは出ずに 866437cb7a794bce2b727acc0362ee27 と表示されました。Node.js 16.20.2 に入っている OpenSSL は 1.1.1v で、22.23.4 と 24.22.1 は 3.5.9 です。
Node.js 17.0.0 のリリースノートによると、Node.js は 17 から OpenSSL 3.0 を使うようになりました。同じノートには、Node.js 17 で ERR_OSSL_EVP_UNSUPPORTED が出るのは、OpenSSL 3.0 が既定では許していない方式や鍵の長さを、アプリかモジュールが使おうとしているからだろう、とも書かれています。
md4 はその「既定では使えない方式」の1つです。OpenSSL 3.0 の移行ガイドでは、MD2 や DES のような古い方式は「legacy provider」という別の部品に移され、3.0 でも使えるものの既定では読み込まれないと説明されています。同じガイドに「MD4 has been moved to the Legacy Provider」とあり、legacy provider の説明のハッシュの一覧にも MD4 が入っています。
Node.js から使えるハッシュの一覧(crypto.getHashes())を見ても、違いが分かります。
$ node -p "require('node:crypto').getHashes().includes('md4')"
false
Node.js 22.23.4 と 24.22.1 では false、16.20.2 では true でした。Node.js の crypto のドキュメントにも、createHash に渡せる方式は、その環境の OpenSSL が対応しているものによって決まるとあります。
直し方1:自分のコードなら sha256 などに変える
md4 を自分で呼んでいるなら、OpenSSL 3 が既定で使える方式に置き換えるのが根本的な直し方です。'md4' を 'sha256' に変えた hash-sha256.js は、Node.js 22.23.4 と 24.22.1 のどちらでもエラーなしで動きました。
const crypto = require('node:crypto');
console.log(crypto.createHash('sha256').update('hello').digest('hex'));
$ node hash-sha256.js
2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824
方式を変えると、ハッシュの値も長さも変わります。md4 の値をファイル名やデータベースのキーとして保存していたなら、置き換える前の値とは一致しなくなります。
直し方2:webpack 4 のビルドで出るなら webpack を上げる
webpack 4.46.0 を入れ、console.log('hello from webpack'); だけの src/index.js をビルドしました。Node.js 22.23.4 の node で、プロジェクトに入った webpack を node node_modules/.bin/webpack --mode production として起動すると、同じエラーで止まりました(終了コードは1。パスは例示用の値に置き換えています)。
$ node node_modules/.bin/webpack --mode production
node:internal/crypto/hash:101
this[kHandle] = new _Hash(algorithm, xofLen, algorithmId, getHashCache());
^
Error: error:0308010C:digital envelope routines::unsupported
at new Hash (node:internal/crypto/hash:101:19)
at Object.createHash (node:crypto:139:10)
at module.exports (/path/to/app/node_modules/webpack/lib/util/createHash.js:135:53)
at NormalModule._initBuildHash (/path/to/app/node_modules/webpack/lib/NormalModule.js:417:16)
at handleParseError (/path/to/app/node_modules/webpack/lib/NormalModule.js:471:10)
at /path/to/app/node_modules/webpack/lib/NormalModule.js:503:5
at /path/to/app/node_modules/webpack/lib/NormalModule.js:358:12
at /path/to/app/node_modules/loader-runner/lib/LoaderRunner.js:373:3
at iterateNormalLoaders (/path/to/app/node_modules/loader-runner/lib/LoaderRunner.js:214:10)
at Array.<anonymous> (/path/to/app/node_modules/loader-runner/lib/LoaderRunner.js:205:4)
at Storage.finished (/path/to/app/node_modules/enhanced-resolve/lib/CachedInputFileSystem.js:55:16)
at /path/to/app/node_modules/enhanced-resolve/lib/CachedInputFileSystem.js:91:9
at /path/to/app/node_modules/graceful-fs/graceful-fs.js:123:16
at FSReqCallback.readFileAfterClose [as oncomplete] (node:internal/fs/read/context:68:3) {
opensslErrorStack: [
'error:03000086:digital envelope routines::initialization error',
'error:0308010C:digital envelope routines::unsupported'
],
library: 'digital envelope routines',
reason: 'unsupported',
code: 'ERR_OSSL_EVP_UNSUPPORTED'
}
Node.js v22.23.4
スタックの3行目が node_modules/webpack/lib/util/createHash.js です。自分のコードではなく、webpack がモジュールのハッシュを作るために md4 を呼んで止まっています。Node.js 24.22.1 でも同じエラーになり、16.20.2 では同じプロジェクトのビルドが通りました。
webpack 4.47.0 に上げる
webpack 4 のまま直すなら、4.47.0 に上げます。webpack 4.47.0 のリリースノートには「Add support for md4 in Node >=18.」とあります。
npm install -D webpack@4.47.0
上げたあとは、Node.js 22.23.4 と 24.22.1 のどちらでもビルドが通りました。できた dist/main.js を実行すると、hello from webpack と表示されました。ビルドのハッシュ(Hash: 20f4f22df204cc899d1a)は、Node.js 16.20.2 で 4.46.0 を使ったときと同じ値でした。
$ node node_modules/.bin/webpack --mode production
Hash: 20f4f22df204cc899d1a
Version: webpack 4.47.0
Time: 45ms
Built at: 11/15/2026 1:06:31 AM
Asset Size Chunks Chunk Names
main.js 963 bytes 0 [emitted] main
Entrypoint main = main.js
[0] ./src/index.js 35 bytes {0} [built]
4.47.0 でもハッシュの方式は md4 のままで、変わったのは計算する場所です。入った 4.47.0 の lib/util/createHash.js を開くと、Node.js のメジャーバージョンが18以上のときは、OpenSSL ではなく ./hash/md4 を使うように分かれていました。この md4.js には md4 を計算する WebAssembly のコードが入っていて、それを wasm-hash で動かしています。
webpack 5 に移る
npm install -D webpack@5 で入った 5.112.2 では、Node.js 22.23.4 と 24.22.1 のどちらでもビルドが通りました。
$ node node_modules/.bin/webpack --mode production
asset main.js 34 bytes [emitted] [minimized] (name: main)
./src/index.js 35 bytes [built] [code generated]
webpack 5.112.2 compiled successfully in 207 ms
webpack 5.61.0 のリリースノートには「use a wasm md4 implementation for node 17 support」とあります。入った 5.112.2 の lib/util/createHash.js でも、"md4" を指定したときは ./hash/md4 を使っていました。
設定でハッシュの方式を変えても直らない
webpack 4.46.0 のまま、設定でハッシュの方式を sha256 に変えてみました。
module.exports = {
output: { hashFunction: 'sha256' },
};
この設定でビルドすると、webpack のモジュールのハッシュでは止まらなくなりましたが、最後に ERROR in main.js from Terser と出て、終了コードは1でした。スタックは次のとおりで(一部を抜粋し、パスは例示用の値に置き換えています)、コードを縮める terser-webpack-plugin の中の createHash で、同じエラーになっていました。
ERROR in main.js from Terser
Error: error:0308010C:digital envelope routines::unsupported
at new Hash (node:internal/crypto/hash:101:19)
at Object.createHash (node:crypto:139:10)
at internalCreateHash (/path/to/app/node_modules/terser-webpack-plugin/dist/index.js:36:28)
output.hashFunction を変えても、terser-webpack-plugin が作るハッシュには効きませんでした。webpack そのものを上げるほうが確実です。
直し方3:すぐに上げられないときは –openssl-legacy-provider を付ける
コードも webpack もすぐには変えられないときは、Node.js に --openssl-legacy-provider を付けると、md4 を含む古い方式が使えるようになります。Node.js のコマンドラインのドキュメントでは「Enable OpenSSL 3.0 legacy provider.」と説明されています。
$ node --openssl-legacy-provider hash.js
866437cb7a794bce2b727acc0362ee27
Node.js 22.23.4 と 24.22.1 のどちらでも、Node.js 16.20.2 と同じハッシュが表示されました。付けたときは、getHashes() の一覧にも md4 が入りました(true)。
npm のスクリプトや webpack のように、node コマンドを直接打たないときは、環境変数 NODE_OPTIONS で渡します。同じドキュメントの NODE_OPTIONS の節にある、指定してよいオプションの一覧にも入っています。webpack 4.46.0 のプロジェクトで試すと、ビルドが通りました。
$ NODE_OPTIONS=--openssl-legacy-provider npx webpack --mode production
Hash: 20f4f22df204cc899d1a
Version: webpack 4.46.0
Time: 133ms
Built at: 11/15/2026 1:06:27 AM
Asset Size Chunks Chunk Names
main.js 963 bytes 0 [emitted] main
Entrypoint main = main.js
[0] ./src/index.js 35 bytes {0} [built]
これは一時しのぎです。Node.js 17.0.0 のリリースノートでも「temporary workaround(一時的な回避策)」と書かれています。このオプションで読み込まれる legacy provider には、OpenSSL の説明によると、使われなくなったものや安全でないとされたものが集められています。md4 だけでなく、そうした方式がまとめて使えるようになるので、使うのは webpack を上げるまでの間にとどめます。
なお、--openssl-legacy-provider は、公式ドキュメントでは v16.17.0 で追加されたとありますが、nodejs.org で配布されている 16.20.2(OpenSSL 1.1.1v)では使えませんでした。付けると bad option: --openssl-legacy-provider と出て、終了コード9で起動しませんでした。





