Node.js で「error:0308010C:digital envelope routines::unsupported」が解決できない
Node.js 17 以降が OpenSSL 3 を採用し、webpack 4 系など古いツールが使う非推奨ハッシュが拒否されるためです。
ツールを更新するか、暫定的に --openssl-legacy-provider を付けて回避します。
公開: 更新:
要約
Error: error:0308010C:digital envelope routines::unsupported は、Node.js 17 以降が同梱する OpenSSL 3 が、webpack 4 系などの古いビルドツールが使う非推奨ハッシュアルゴリズムを拒否することで発生します。
恒久対策はツールチェーンの更新、即効性のある回避は --openssl-legacy-provider の付与です。
よくある原因
- OpenSSL 3 への移行: Node.js 17 で OpenSSL 3 が標準になり、MD4 など弱いアルゴリズムが既定で無効化された。
- webpack 4 の内部依存: webpack 4 はチャンクのハッシュ生成に旧アルゴリズムを使うため、新しい Node でそのまま落ちる。
- 古い CRA / scripts:
react-scripts4 系などが webpack 4 を内包しており、Node を上げた瞬間に再現する。
解決策
1. 環境変数で暫定回避する
すぐビルドを通したい場合は legacy provider を有効化します。
export NODE_OPTIONS=--openssl-legacy-provider
npm run buildこのフラグは公式 CLI ドキュメント（新しいタブで開く）に記載された正式オプションですが、弱い暗号を許可する点に注意してください。
2. ツールチェーンを更新する（恒久対策）
webpack 5 系へ上げると根本解決します。
npm install webpack@latest webpack-cli@latest --save-dev
# CRA なら react-scripts を 5 以上へ
npm install react-scripts@latest3. Node のバージョンを固定する
更新が難しい既存プロジェクトは、.nvmrc で Node 16 系に固定する暫定運用も可能です。
ただし Node 16 は EOL のため、あくまで移行までのつなぎとし、最終的には依存更新を行ってください。
実行例
実際に上記の手順を node:20（v20.20.2 / OpenSSL 3.0.19）環境で動かすと、MD4 ハッシュを要求した時点で ERR_OSSL_EVP_UNSUPPORTED が発生し（終了コード 1）、--openssl-legacy-provider または NODE_OPTIONS 経由での付与によって解消されることが確認できます。
$ node --version
v20.20.2$ node -p "process.versions.openssl"
3.0.19$ 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> (/tmp/tmp.mao1Q7OMPi/hash.js:3:18)
at Module._compile (node:internal/modules/cjs/loader:1521:14)
at Module._extensions..js (node:internal/modules/cjs/loader:1623:10)
at Module.load (node:internal/modules/cjs/loader:1266:32)
at Module._load (node:internal/modules/cjs/loader:1091:12)
at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:164:12)
at node:internal/main/run_main_module:28: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 v20.20.2
終了コード: 1$ node --openssl-legacy-provider hash.js
md4: 19c8b5f7626080fbb0944d4203f1c784
終了コード: 0$ NODE_OPTIONS=--openssl-legacy-provider node hash.js
md4: 19c8b5f7626080fbb0944d4203f1c784
終了コード: 0$ node -e "console.log('sha256:', require('node:crypto').createHash('sha256').update('dekinai').digest('hex'))"
sha256: 24ad36a1afb9ce6cbebf8d6c383069df80e12f8f56ec1b602d0c8050724f4e30— 2026-08-02 時点の出力
検証環境
- 検証日
- 実行環境
node:20
この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。