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