Joplin-解决 Node.js 中 “digital envelope routines::unsupported“ 错误

解决 Node.js 中 "digital envelope routines::unsupported" 错误

在使用 Webpack 构建 Joplin 插件时,你可能会遇到 error:0308010C:digital envelope routines::unsupported 错误。这个错误看起来很复杂,但实际上有明确的原因和解决方案。

错误原因分析

这个错误发生在 Node.js v17+ 版本中,根源是:

  • Node.js v17+ 升级到了 OpenSSL 3.0
  • OpenSSL 3.0 移除了一些不安全的加密算法(如 MD4)
  • 旧版本的 Webpack(如我们项目中使用的 4.46.0)仍在使用这些被移除的算法

当你运行 npm run dist 时,Webpack 尝试使用已被移除的加密算法,导致 Node.js 抛出此错误。

解决方案

方案 1:设置环境变量(推荐)

这是最简单快捷的解决方案,通过环境变量强制 Node.js 使用旧的加密模式:

Windows 命令提示符:

cmd 复制代码
set NODE_OPTIONS=--openssl-legacy-provider
npm run dist

Windows PowerShell:

powershell 复制代码
$env:NODE_OPTIONS = "--openssl-legacy-provider"
npm run dist

Linux/macOS:

bash 复制代码
export NODE_OPTIONS=--openssl-legacy-provider
npm run dist

方案 2:降级 Node.js 版本

如果希望长期使用而不设置环境变量,可以降级 Node.js 到 v16.x 或更低版本:

  1. 卸载当前的 Node.js v20.17.0
  2. 从 Node.js 官网 下载并安装 v16.x LTS 版本
  3. 重新运行 npm run dist

方案 3:升级 Webpack 及相关依赖

这是最彻底但也最复杂的解决方案:

  1. 升级 Webpack 到 5.x 版本:
bash 复制代码
npm install webpack@5 --save-dev
  1. 升级相关 loader 和插件:
bash 复制代码
npm install ts-loader@latest webpack-cli@latest --save-dev
  1. 根据需要调整 Webpack 配置文件以适应新版本的 API 变化
bash 复制代码
# 查看项目局部版本
npx webpack -v

# 查看全局版本(若全局安装)
webpack -v

为什么这些方案有效?

  • 方案 1 通过 --openssl-legacy-provider 选项让 Node.js 启用旧的加密算法支持,兼容 Webpack 4 的需求
  • 方案 2 使用仍支持旧加密算法的 Node.js 版本,从根本上避免了兼容性问题
  • 方案 3 升级到支持 OpenSSL 3.0 的 Webpack 版本,彻底解决了兼容性问题

总结

对于 Joplin 插件开发这类可能依赖特定版本构建工具的场景,我推荐优先使用方案 1(设置环境变量),它既能解决问题,又不会影响项目的其他依赖和配置。

如果计划长期维护这个项目,那么方案 3(升级 Webpack)是更好的选择,可以避免未来可能出现的其他兼容性问题。

相关推荐
木头左1 天前
【浏览器自动化】用 CDP 接管本机 Chrome:从一个宿主迁到另一个宿主的设计与踩坑
node.js·浏览器自动化·cdp·技能化·踩坑实践
cpolar技术支持2 天前
把 agent-autoloop 装在 Mac 上:用本机 Node 实跑一次「接活—提问—拍板—接着干」,再用 cpolar 把它的状态页开给不在工位的自己
node.js·内网穿透·cpolar·ai agent·agent-autoloop
SEO_juper2 天前
Node.js 全站 SEO 体检报告生成器:一次查完标题、描述、canonical、H1、图片
开发语言·前端·node.js·html·bash
木头左3 天前
【Node.js】Markdown 转带图片 Word 文档实战:docx 库转换器设计与 5 个踩坑
node.js·word·markdown·文档自动化
思特奇时空智能3 天前
大规模点要素地图渲染性能优化实践
vue.js·arcgis·性能优化·node.js·html·gis·webgl
w3296362715 天前
飞书接单到月度结算:我用一个 DSH 插件跑通鞋类采购 WMS,附 22 项验收
pdf·node.js·飞书·后端开发·ai agent
濮水大叔6 天前
Cabloy/Vona 为什么不需要 NestJS 的 Dynamic Module
typescript·node.js·nestjs
匠云创新6 天前
读完一万段要两分钟:我们把标书读取从 WPS 对象模型搬到了 docx 解析
性能优化·node.js
某哈压力大6 天前
SSH 突然 Connection reset?不是密钥坏了,是 OpenSSL 把 sshd 干趴了
前端·node.js·命令行
回眸&啤酒鸭6 天前
【回眸】Node.js 新手从零到一实战指南
node.js