升级 node.js 后，编译时报错error:0308010C:digital envelope routines::unsupported

最新推荐文章于 2026-04-08 13:52:58 发布

原创最新推荐文章于 2026-04-08 13:52:58 发布 · 5k 阅读

11 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#node.js #laravel

Laravel 同时被 2 个专栏收录

2 篇文章

订阅专栏

node.js

1 篇文章

订阅专栏

在升级到Node.jsv17及以上版本后，由于OpenSSL3.0的更改导致编译错误0308010C。为了解决这个问题，可以在package.json的启动脚本中添加`NODE_OPTIONS=--openssl-legacy-provider`，这允许使用旧的加密提供者，从而避免编译错误。通过修改这个设置，可以成功运行npmrunwatch并进行编译。

系统重装成 win11, node.js 也安装成了最新的 v18.13.0 , 修改基于laravel 的 lims 系统，想重新编译，然后报错 error:0308010C:digital envelope routines::unsupported：

e:\e-lims> npm run watch

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

Error: error:0308010C:digital envelope routines::unsupported
......
Node.js v18.13.0

出现这个错误的原因，是 node.js V17版本后使用了OpenSSL3.0, OpenSSL3.0对允许算法和密钥大小增加了严格的限制，改变了md族(包括md4)的初始化上下文的代码，这是一个破坏性的更改。

解决的方案之一是修改 package.json 中的相关脚本

原部分脚本为：

{
    "private": true,
    "scripts": {
        "dev": "npm run development",
        "development": "mix",
        "watch": "mix watch",
        "watch-poll": "mix watch -- --watch-options-poll=1000",
        "hot": "mix watch --hot",
        "prod": "npm run production",
        "production": "mix --production"
    },
......
}

启动脚本前，设置NODE_OPTIONS，这不是一个推荐的方法，但可以解决问题

{
    "private": true,
    "scripts": {
        "dev": "set NODE_OPTIONS=--openssl-legacy-provider && npm run development",
        "watch": "set NODE_OPTIONS=--openssl-legacy-provider && mix watch",
        
    },
......
}

再次运行 npm run watch ,可顺利编译。