解决Node.js错误：“error:0308010C:digital envelope routines::unsupported”:

博主：小蓝
发布时间：2024 年 01 月 02 日
734 次浏览
暂无评论
2036字数
分类： Linux 技术杂烩

Node.js中"error:0308010C:digital envelope routines::unsupported"错误通常发生在试图使用加密功能时，这是由于Node.js底层使用的OpenSSL库不支持某些加密算法，尤其是在升级到Node.js 17版本后，由于OpenSSL升级到3.0，导致对旧算法的支持有所变化。这种问题在尝试构建或运行一些依赖这些旧算法的应用时尤为常见。![](https://www.8kiz.cn/usr/uploads/2023/12/1112683138.png)

解决此问题的策略通常包括以下几个步骤：

1. **降级Node.js版本**：考虑切换到LTE (Long Term Support) 版本，例如Node.js 16.x或更早版本，因为它们使用的是较旧版本的OpenSSL，可能还支持该加密算法。
2. **设置环境变量**：暂时的解决方案是设置环境变量，以便使用兼容的OpenSSL配置。可以通过设置 `NODE_OPTIONS`环境变量为 `--openssl-legacy-provider`来达到这个目的，例如在Unix-like系统中可以通过如下命令实现：

```bash
   export NODE_OPTIONS=--openssl-legacy-provider
   ```

在Windows系统中，则需要使用以下命令：

```bash
   set NODE_OPTIONS=--openssl-legacy-provider
   ```

这告诉Node.js运行时使用传统的OpenSSL提供者，这可以让一些旧算法继续工作。
3. **代码修改**：如果是自己维护的代码，检查并更新加密算法的使用，以使用OpenSSL 3.0支持的算法。
4. **依赖更新**：如果问题源自第三方依赖，则检查是否有可用的更新版本，它们可能已经解决了与OpenSSL 3.0的兼容性问题。
5. **重新编译**：在某些情况下，如果你是从源码编译Node.js的，则可以尝试在编译时指定使用更老版本的OpenSSL。
6. **联系依赖维护者**：如果你使用的是第三方库或模块，并且没有更新解决这个问题，可以尝试联系其维护者寻求支持或下一步的指导。
7. **报告问题**：如果上述方法都未能解决问题，可以在Node.js的GitHub仓库中报告这个错误，贡献社区讨论，并寻求更多的帮助。

在应用上述解决方案前，请确保你的Node.js应用程序的所有依赖都是最新的，这可以通过运行 `npm update`来实现。同时，始终备份你的工作，以防需要回滚所做的任何更改。通过这些步骤，多数情况下应该能够解决"error:0308010C:digital envelope routines::unsupported"错误问题。这些解决方案能确保应用程序可以顺利运行，同时也为今后可能的OpenSSL库更新做好了准备。

#### [云服务器/高防CDN推荐](https://www.tsyvps.com/)

#### [蓝易云](https://www.tsyvps.com/)国内/海外高防云服务器推荐

<div class="inner-content" >
<p class="inser-title">蓝易云-五网CN2服务器【点我购买】</p>
<div class="inster-summary text-muted">
<span style='color: red;'>蓝易云采用KVM高性能架构，稳定可靠，安全无忧！<br>蓝易云服务器真实CN2回国线路，不伪造，只做高质量海外服务器。</span>
</div>
</div>
</a>

</div>

</div>

---

**<span style='color:#000000'>海外免备案云服务器链接：[www.tsyvps.com](https://www.tsyvps.com)</span>**

**<span style='color:#000000'>蓝易云安全企业级高防CDN：[www.tsycdn.com](https://www.tsycdn.com)</span>**

**<span style='color:#DC143C'>持有增值电信营业许可证：B1-20222080【资质齐全】</span>**

**<span style='color:#DC143C'>蓝易云香港五网CN2 GIA/GT精品网络服务器。拒绝绕路，拒绝不稳定。</span>**

---

#### **百度搜索：[蓝易云](https://www.baidu.com/s?ie=UTF-8&wd=%E8%93%9D%E6%98%93%E4%BA%91)**![](https://www.8kiz.cn/usr/uploads/2023/12/2107500647.png)