Node.js 常见问题

error:0308010C envelope routines::unsupported#

1
node:internal/crypto/hash:67
2
  this[kHandle] = new _Hash(algorithm, xofLen);
3
                  ^
4

5
Error: error:0308010C:digital envelope routines::unsupported
6
    at new Hash (node:internal/crypto/hash:67:19)
7
    at Object.createHash (node:crypto:133:10)

:::tip 解决方案

错误原因#

在 Node.js v17 中，Node.js 开发人员关闭了 SSL 提供程序中的一个安全漏洞。此修复是一项重大更改，与 NPM 中 SSL 包中的类似重大更改相对应。当您尝试在 Node.js v17 或更高版本中使用 SSL 而不升级 package.json 中的那些 SSL 包时，您将看到此错误。

危险的解决方案#

将 Node.js 版本从 17+ 降级到 16+，或者使用旧的 SSL 提供程序。但这两种解决方案都是使您的构建容易受到安全威胁的黑客攻击。

1
# Linux and macOS
2
export NODE_OPTIONS=--openssl-legacy-provider
3

4
# Windows
5
set NODE_OPTIONS=--openssl-legacy-provider
6

7
# Windows PowerShell
8
$env:NODE_OPTIONS = "--openssl-legacy-provider"

正确（安全）的解决方案#

使用最新版本的 Node.js，并使用最新的带有安全修复程序的包。以下命令将解决此问题（注意：对于复杂的应用，此命令会引入可能破坏原程序构建的安全修复）：

1
npm audit fix --force

参考资料#

Error message “error:0308010C envelope routines::unsupported”

:::