node 17+ · npm
报错原文
Error: error:0308010C:digital envelope routines::unsupported
这是什么意思
node 17 换上了 OpenSSL 3，把一个老的哈希算法从默认里去掉了，而仍然要用它的工具就在那次哈希调用里当场倒下。这几乎总是一个老的 webpack 4，或者内含 webpack 4 的工具，跑在现代 node 上。export NODE_OPTIONS=--openssl-legacy-provider 只为那个进程重新打开老算法，用于构建没有害处。但这是在硬撑一个已死的工具：升到 webpack 5，或者升到你框架的当前版本，这个选项就完全不需要了。
怎么修
export NODE_OPTIONS=--openssl-legacy-provider- 来自
- node 17+
- npm
- 20
npm 的原因写在第一行 code XXXX 里，而不是最后那六行 npm ERR!；如果失败来自依赖树或原生编译而不是你自己的代码，删掉 node_modules 重新安装就能解决一半。
怎么读报错
- 从第一行往下读。越往下越是工具内部的事，起因通常写在最上面。
- 有文件名和行号就从那里查——不是栈顶那一帧，而是最上面那条提到你自己写的文件的行。
- 把报错原文照样去搜，但先去掉你自己的路径和变量名，正是那些让搜索匹配不上。
- 同一种情况在不同版本里措辞不同。结果不对头，就把版本号一起加进查询。
- 粘贴修法之前，先确认它会丢掉什么。这里面有些是不能撤回的。
常见问题
Q. “Error: error:0308010C:digital envelope routines::unsupported” 是什么意思？
node 17 换上了 OpenSSL 3，把一个老的哈希算法从默认里去掉了，而仍然要用它的工具就在那次哈希调用里当场倒下。这几乎总是一个老的 webpack 4，或者内含 webpack 4 的工具，跑在现代 node 上。export NODE_OPTIONS=--openssl-legacy-provider 只为那个进程重新打开老算法，用于构建没有害处。但这是在硬撑一个已死的工具：升到 webpack 5，或者升到你框架的当前版本，这个选项就完全不需要了。
Q. 怎么修？
export NODE_OPTIONS=--openssl-legacy-provider —— 执行前先看上面的说明，确认这条命令会丢掉什么。
Q. 这是哪个工具报的？
node 17+。它属于npm，报错原文有 4 个词。
相关报错
npm WARN EBADENGINE Unsupported enginenpmFATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memorynodezsh: command not found: tscshellnpm ERR! ERESOLVE unable to resolve dependency treenpmnpm ERR! Conflicting peer dependency: react@18.3.1npmnpm WARN react-dom@17.0.2 requires a peer of react@17.0.2 but none is installed.npm 6npm WARN deprecated request@2.88.2: request has been deprecatednpmnpm ERR! npm ci can only install packages when your package.json and package-lock.json or npm-shrinkwrap.json are in sync.npm