Nuxt.js遇不支持的信封例程时，替代--openssl-legacy-provider的方案

我通过以下命令创建Nuxt.js项目：

npx create-nuxt-app <project-name>

采用Nuxt最小配置（所有设置直接回车），但运行npm run start、npm run build、npm run dev时均出现相同错误，核心错误为error:0308010C:digital envelope routines::unsupported，完整错误输出如下：

node:internal/crypto/hash:71
  this[kHandle] = new _Hash(algorithm, xofLen);
                ^

Error: error:0308010C:digital envelope routines::unsupported
    at new Hash (node:internal/crypto/hash:71:19)
    at Object.createHash (node:crypto:140:10)
    at module.exports (/home/me/dev/code/Javascript/Nuxt/first-nux-app/node_modules/webpack/lib/util/createHash.js:135:53)
    at NormalModule._initBuildHash (/home/me/dev/code/Javascript/Nuxt/first-nux-app/node_modules/webpack/lib/NormalModule.js:417:16)
    at handleParseError (/home/me/dev/code/Javascript/Nuxt/first-nux-app/node_modules/webpack/lib/NormalModule.js:471:10)
    at /home/me/dev/code/Javascript/Nuxt/first-nux-app/node_modules/webpack/lib/NormalModule.js:503:5
    at /home/me/dev/code/Javascript/Nuxt/first-nux-app/node_modules/webpack/lib/NormalModule.js:358:12
    at /home/me/dev/code/Javascript/Nuxt/first-nux-app/node_modules/webpack/node_modules/loader-runner/lib/LoaderRunner.js:373:3
    at iterateNormalLoaders (/home/me/dev/code/Javascript/Nuxt/first-nux-app/node_modules/webpack/node_modules/loader-runner/lib/LoaderRunner.js:214:10)
    at Array.<anonymous> (/home/me/dev/code/Javascript/Nuxt/first-nux-app/node_modules/webpack/node_modules/loader-runner/lib/LoaderRunner.js:205:4)
    at Storage.finished (/home/me/dev/code/Javascript/Nuxt/first-nux-app/node_modules/enhanced-resolve/lib/CachedInputFileSystem.js:55:16)
    at /home/me/dev/code/Javascript/Nuxt/first-nux-app/node_modules/enhanced-resolve/lib/CachedInputFileSystem.js:91:9
    at /home/me/dev/code/Javascript/Nuxt/first-nux-app/node_modules/graceful-fs/graceful-fs.js:123:16
    at FSReqCallback.readFileAfterClose [as oncomplete] (node:internal/fs/read_file_context:68:3) {
  opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ],
  library: 'digital envelope routines',
  reason: 'unsupported',
  code: 'ERR_OSSL_EVP_UNSUPPORTED'
}

我运行在Arch Linux最小化环境中，已更新Node.js和OpenSSL，不确定是否缺少依赖。目前用--openssl-legacy-provider标志可解决问题，但担心使用SSL旧版提供者会带来安全漏洞，想知道：

1. 这是Nuxt.js/Node.js的常见问题，还是本地环境问题？
2. 有没有更优的解决方案？

问题本质 #

这是Node.js 17+版本的常见兼容性问题：Node.js 17及以上默认启用OpenSSL 3.0，废弃了部分旧哈希算法（如MD4），而Nuxt 2默认依赖的旧版Webpack仍在使用这些被废弃的算法，导致冲突。该问题和Nuxt生成SSL证书无关，也不是本地环境缺失依赖导致的核心问题。

替代--openssl-legacy-provider的安全方案 #

1. 升级Nuxt版本 #

• 若使用Nuxt 2，升级到最新补丁版本：它会同步升级依赖的Webpack版本，修复哈希算法兼容问题

  npm install nuxt@latest --save
  

• 若允许重构项目，直接切换到Nuxt 3：其依赖的Webpack 5已完全适配OpenSSL 3.0

  npx nuxi init <project-name>
  

2. 单独升级Webpack到兼容版本 #

如果无法升级Nuxt，可手动将项目的Webpack升级到5.x版本（已支持OpenSSL 3.0）：

npm install webpack@^5.0.0 --save-dev

注意：升级后可能需要同步调整相关loader配置，确保项目构建正常。

3. 指定Node.js使用安全哈希算法 #

在项目根目录创建.env文件，添加以下环境变量，强制Node.js使用OpenSSL 3.0支持的SHA256算法：

NODE_OPTIONS=--openssl-hash-algorithm=sha256

此方法无需启用旧版提供者，直接替换为安全的现代算法，兼容性与安全性兼顾。

4. 切换到Node.js 16 LTS版本 #

Node.js 16 LTS仍默认使用OpenSSL 1.1.1，不会触发该兼容性问题，适合需要保留旧项目配置的场景：

# 安装nvm（若未安装）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 安装Node.js 16 LTS
nvm install 16
# 切换到Node.js 16
nvm use 16

环境依赖补充检查 #

Arch Linux最小化环境下，建议安装base-devel包组，它包含Node.js构建项目所需的基础编译工具：

sudo pacman -S base-devel

缺少该包组可能导致依赖安装或构建失败，但不是本次错误的直接原因。

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