解决 Node.js 启动报错：digital envelope routines 错误全记录
问题起源
今天在维护一个许久未更新的旧项目时，启动过程中遭遇了一个棘手的错误：
error:03000086:digital envelope routines::initialization error
这个项目已经有一段时间没有进行开发，突然需要紧急修改功能，却在第一步启动环境时就遇到了阻碍。
问题分析
经过排查，这个错误通常与 OpenSSL 配置有关。OpenSSL 作为一个开源加密工具库，为 SSL/TLS 协议提供底层支持，在 Node.js 中承担着加密解密、数字签名等安全通信的重要职责。当我们执行 npm run dev 启动本地开发服务器时，Node.js 正是依赖 OpenSSL 来完成这些安全操作。
解决方案
根本原因定位：
问题出现在 NODE_OPTIONS 环境变量中设置的 --openssl-legacy-provider 选项。这个选项原本用于启用 OpenSSL 1.0.x 的兼容模式，但在 Node.js 14.x 及以上版本中，该选项已被官方禁用。
解决步骤：
- 查阅项目历史部署记录，发现原开发环境使用的是 Node.js 16 版本
- 而我当前本地环境为 Node.js 18，版本不兼容导致报错
- 使用 nvm 安装并切换至对应的 Node.js 16.20.0 版本：
nvm install 16.20.0
nvm use 16.20.0
node -v # 验证版本切换成功
- 重新执行 npm run dev，项目顺利启动！
替代方案
在调研过程中，我还发现了另一种临时解决方案：在 package.json 文件中修改 scripts 配置：
{"scripts": {"dev": "SET NODE_OPTIONS=--openssl-legacy-provider && vue-cli-service serve"}
}
这种方法通过在每个命令前设置环境变量来绕过兼容性问题。虽然能够快速解决问题，但考虑到需要在每个相关命令中都添加这个前缀，我最终选择了版本降级的方案。不过对于需要紧急修复或者没有安装 nvm 的环境来说，这确实是一个值得考虑的快捷解决办法。
经验总结
这次经历再次提醒我们，在接手旧项目时，首先确认其原始开发环境版本至关重要。版本兼容性问题虽然常见，但只要找准方向，解决起来并不困难。