如何让Node.js 16/18兼容使用OpenSSL旧提供器运行Yarn脚本？

问题背景 #

维护一套基于Webpack 4、通过yarn运行的遗留构建系统，同时在本地开发环境和云端流水线部署。近期云端构建代理会随机分配Node 18（原默认Node 16），但Node 18默认的OpenSSL提供器不再支持Webpack 4硬编码使用的md4哈希算法，导致构建失败。Node 18提供了--openssl-legacy-provider参数强制启用旧提供器，但部分低版本Node 16不支持该参数，直接添加会报错。

核心需求：无需提前知晓运行环境是Node 16还是18，自动适配并启用OpenSSL旧提供器完成构建。

可行解决方案（按优先级排序） #

方案1：动态判断Node版本添加参数（推荐） #

通过脚本自动检测Node主版本号，决定是否添加--openssl-legacy-provider参数，实现跨版本兼容。

方式1：Shell脚本判断（适用于bash/zsh环境）

在package.json中拆分构建命令，用条件判断逻辑适配版本：

"scripts": {
  "build": "if [ $(node -v | cut -d'v' -f2 | cut -d'.' -f1) -ge 18 ]; then NODE_OPTIONS=\"--openssl-legacy-provider\" yarn run build:core; else yarn run build:core; fi",
  "build:core": "webpack --config webpack.config.js"
}

方式2：Node前置脚本（跨平台兼容）

创建pre-build.js脚本作为构建入口：

const { execSync } = require('child_process');
const nodeMajorVersion = parseInt(process.versions.node.split('.')[0], 10);

if (nodeMajorVersion >= 18) {
  process.env.NODE_OPTIONS = '--openssl-legacy-provider';
}

execSync('yarn run build:core', { stdio: 'inherit' });

修改package.json的脚本配置：

"scripts": {
  "build": "node pre-build.js",
  "build:core": "webpack --config webpack.config.js"
}

该方案无需依赖特定Shell环境，适配Windows、Linux、macOS全平台。

方案2：全局配置OpenSSL默认提供器 #

通过配置文件强制所有Node版本启用legacy提供器，无需修改构建脚本。

1. 创建openssl.cnf文件，内容如下：

openssl_conf = openssl_init

[openssl_init]
providers = provider_sect

[provider_sect]
default = default_sect
legacy = legacy_sect

[default_sect]
activate = 1

[legacy_sect]
activate = 1

2. 配置环境变量OPENSSL_CONF指向该文件：

• 云端流水线：在构建任务中添加环境变量（如Azure DevOps可在变量组设置OPENSSL_CONF=$(Build.SourcesDirectory)/openssl.cnf）；
• 本地开发环境：
  • Linux/macOS：在.bashrc/.zshrc中添加export OPENSSL_CONF=/绝对路径/openssl.cnf；
  • Windows：在系统环境变量中新增OPENSSL_CONF，值为文件绝对路径；或临时设置：set OPENSSL_CONF=C:\绝对路径\openssl.cnf && yarn build。

方案3：锁定Node版本范围（临时过渡） #

指定Node版本为>=16.17.0（该版本开始Node 16反向移植了--openssl-legacy-provider参数支持），直接在脚本中添加参数即可：

在package.json中声明版本要求：

"engines": {
  "node": ">=16.17.0"
}

修改构建脚本：

"scripts": {
  "build": "NODE_OPTIONS=\"--openssl-legacy-provider\" webpack --config webpack.config.js"
}

不推荐方案说明 #

• 强制锁定Node 16：仅临时缓解，无法应对Node 16停止维护的长期风险；
• 升级Webpack 5：依赖的第三方插件无适配版本，改造工作量过大；
• 全量升级至Node 18：需同步更新所有本地开发环境及构建代理，成本高，仅作为最后手段。

内容的提问来源于stack exchange，提问作者Brooke Hart