把Node.js从16升到18,代码一行没动,跑npm run build直接崩,终端刷出Error: error:0308010C:digital envelope routines::unsupported,堆栈顶上是node:internal/crypto/hash:67,往下第二行是webpack/lib/util/createHash.js:135,再往下是NormalModule.js:417的_initBuildHash。这类报错碰到过好几次,报错里还带着opensslErrorStack: ['error:03000086:digital envelope routines::initialization error']和code: 'ERR_OSSL_EVP_UNSUPPORTED'。原因不在业务代码:Node 17把内置的OpenSSL从1.1.1换到3.0,MD4这类老算法被挪进legacy provider且默认不加载,而webpack 4默认拿MD4算模块hash,一调crypto.createHash('md4')就抛这个错。之前接手过一台CI机器,管理员批量升了Node,几个老项目同一天集体构建失败,折腾半天才发现全卡在这儿。
不是代码写错了,是哈希算法被系统禁了。
1、先把版本和触发点坐实。node -v看当前大版本,17以上基本都对得上;再单独跑一句node -p "require('crypto').createHash('md4')",能复现就说明当前Node确实没加载legacy provider,跟webpack无关。npm ls webpack看项目实际装的版本,react-scripts、vue-cli-service、@angular/cli这些脚手架会把webpack藏在自己依赖里,得用npm ls react-scripts一起看。堆栈里createHash.js那一行最直白,出现它就不用再去翻业务代码了。
node -v
node -p "require('crypto').createHash('md4')"
npm ls webpack
npm ls react-scripts
2、赶时间就先临时开legacy provider。Linux和macOS在终端export NODE_OPTIONS=--openssl-legacy-provider,Windows的cmd用set NODE_OPTIONS=--openssl-legacy-provider,PowerShell写$env:NODE_OPTIONS="--openssl-legacy-provider",然后照常npm run build。这个开关只对当前进程有效,关掉终端就没了,CI里得写进环境变量或者Dockerfile的ENV NODE_OPTIONS=--openssl-legacy-provider。跨平台的项目别在package.json里直接写export,装个cross-env把scripts改成"build": "cross-env NODE_OPTIONS=--openssl-legacy-provider webpack",或者在项目根放.npmrc写node-options=--openssl-legacy-provider。实测Node 20的早期小版本在部分平台上会反过来报node: --openssl-legacy-provider is not allowed in NODE_OPTIONS,遇到这句就别硬扛,直接走后面两条。
export NODE_OPTIONS=--openssl-legacy-provider npm run build set NODE_OPTIONS=--openssl-legacy-provider $env:NODE_OPTIONS="--openssl-legacy-provider" npm install -D cross-env node-options=--openssl-legacy-provider
3、不想留后门就改哈希算法。webpack 5.54.0以上在output里加hashFunction: 'xxhash64',绕开MD4;webpack 4没有xxhash64,改成'sha256'或'sha512'也能过,代价是构建产物文件名里的hash全长变样,长缓存会跟着失效。Vue CLI 4在vue.config.js里用configureWebpack包一层output,Angular在angular.json的build.options里加hashFunction。CRA把配置藏在react-scripts里,webpack.config.js根本改不到,除非eject出来自己维护。有人在vue.config.js顶部拦截crypto.createHash、把md4换成md5,能跑起来但hash结果全变了,只当临时兜底,别拿它当正式方案。
// webpack.config.js
module.exports = {
output: { hashFunction: 'xxhash64' }
};
// vue.config.js
module.exports = {
configureWebpack: { output: { hashFunction: 'sha256' } }
};
4、真要解决还是升依赖。webpack 5.61.0换成了wasm实现的MD4,不再走OpenSSL的provider;webpack 4.47.0也补了Node 18及以上的MD4支持,但loader和插件自己调md4的还是会挂,升完得全量回归一遍。react-scripts 4.0.3把webpack锁在4.44.2,装不进修复,升到react-scripts 5.0.0(内置webpack 5)最省事。Create React App在2025年2月官方废弃,新项目直接迁Vite更干净。降回Node 16也能绕开,但Node 16在2023年9月11日已经EOL,等于拿安全问题换构建能过,不划算。当初那台CI最后是统一升到webpack 5.61.0,把临时开关从scripts里删掉才收工。
5、验证别只看本机。把NODE_OPTIONS撤掉再跑一遍npm run build,能过才算真修好;CI镜像里复核一次node -v和npm ls webpack,别本机过了、上线又崩一次。查了半天的那几个老项目,最后差异都在react-scripts版本上,跟业务代码一点关系没有。
Node.js 17.0.0、17.3.0、18.0.0、20.0.0、22.0.0,从17.0.0起都带OpenSSL 3,这条报错不会随着升版本自己消失;webpack 4.44.2、4.47.0、5.54.0、5.61.0,哈希实现各不一样,5.54.0起才有xxhash64可用,5.61.0才把MD4换成wasm版。react-scripts 4.0.3、5.0.0、5.0.1,分界线就在5.0.0换webpack 5那次。Node.js 17.0.0是2021年10月发的,Node 16于2023年9月11日停服,Node 18于2025年4月30日停服,Node 20于2026年4月30日停服,老项目拖着不升,能用的LTS只会越来越少。数据截至2026年11月。