Node 18.20 升级后打包报 ERR_OSSL_EVP_UNSUPPORTED 换版本还是改参数

CI 上的 Node 从 16.20.2 换到 18.20.4,npm run build 直接挂,报 Error: error:0308010C:digital envelope routines::unsupported,栈顶在 webpack/lib/util/createHash.js:135。开发机上 Node 还是 16,本地永远复现不出来。

0308010C 是 OpenSSL 3 的错误码。Node 18 起自带的 OpenSSL 是 3.x,把 md4 这类老算法挪进了 legacy provider,默认不加载。webpack 4 的默认 hashFunction 正好是 md4,一调用就炸。

最省事的写法是 NODE_OPTIONS=--openssl-legacy-provider,我试过,能过。但把它写进 CI 全局变量,整个构建链都退到 legacy,别的服务跟着受影响;在 Windows 的 cmd 里传这个参数,引号和等号还容易被吃掉,报 bad option: --openssl-legacy-provider。

项目是 vue-CLI 4,往上升 webpack 5 要换 loader、改 splitChunks,我估了两天,这次排不进去。折中的做法是只在 build 脚本里加前缀,用 cross-env 保证三个平台一致。

{
  "scripts": {
    "serve": "vue-cli-service serve",
    "build": "cross-env NODE_OPTIONS=--openssl-legacy-provider vue-cli-service build"
  }
}

还有一处自己代码里的坑。上传组件用 crypto.createHash('md4') 算文件指纹,Node 18 下报同样的 unsupported,栈在自己模块里。改成 sha256 之后指纹长度变了,历史文件的索引对不上,最后给新指纹加了版本前缀才兼容两批数据。

node-sass 4.14 在 Node 18 下也编不过,报 Node Sass does not yet support your current environment。换成 dart-sass 1.69,样式里 /deep/ 的写法要改 ::v-deep,一共动了 7 个文件。

CI 的 node 版本现在锁在 .nvmrc 里,18.20.4,构建镜像按这个文件装。下次再升,先把那个上传组件的单测跑一遍再合。

您可以还会对下面的文章感兴趣: