Mac 上的「UNABLE_TO_GET_ISSUER_CERT_LOCALLY」
UNABLE_TO_GET_ISSUER_CERT_LOCALLY 表示 Node.js 找不到簽署某張憑證的機構。常見原因是進行 TLS 檢查的代理伺服器或私有機構。
讓你的代理程式來解決拷貝一則提示詞,適用於 Claude Code、Codex 或任何能使用終端機的代理程式。
我的 Mac 出現了這個問題:Mac 上的「UNABLE_TO_GET_ISSUER_CERT_LOCALLY」。請閱讀 https://kilobat.app/zh-hant/guides/npm-unable-to-get-issuer-cert-locally.md,並和我一起逐步處理。如果缺少 Kilobat CLI,請安裝:brew install seifip/kilobat/kilobat。請你自己執行指南中的終端機和 kilobat 檢查,並告訴我發現了什麼。列出只有我才能完成的步驟。變更任何設定之前先問我。
症狀
- 某個 Node.js 工具以
UNABLE_TO_GET_ISSUER_CERT_LOCALLY停止。 - 訊息可能顯示
unable to get local issuer certificate。 - 瀏覽器可能打得開同一個網站。
可能原因
- 進行 TLS 檢查的代理伺服器。公司代理伺服器用自己的憑證簽署流量。請參閱 公司代理伺服器的憑證會讓 Mac 上的終端機工具失效。
- 私有機構。公司的 registry 或閘道使用 Node.js 不認得的機構所簽發的憑證。
- 掃描 HTTPS 的資安 App。它加入了自己的根憑證,而 Node.js 預設不使用它。
- 缺少中繼憑證。伺服器可能漏掉了部分憑證鏈。
如何檢查
讀取簽發者。
curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer顯示 npm 使用的 CA 檔案。
npm config get cafile顯示 Node.js 的 CA 變數。
echo $NODE_EXTRA_CA_CERTS試試手機熱點。
如何修正
向網路管理員取得 PEM 格式的 CA 憑證。
讓 Node.js 在這個 shell 中信任它。
export NODE_EXTRA_CA_CERTS=/path/to/ca.pem對 npm,請設定同一個檔案。
npm config set cafile /path/to/ca.pem請勿設定
NODE_TLS_REJECT_UNAUTHORIZED=0。它會關閉所有檢查。
使用 Kilobat
Kilobat 的連線診斷會逐層測試主機。TLS 層會顯示這部 Mac 不信任的憑證。
kilobat why https://registry.npmjs.org/這些 Kilobat 檢查都是免費的。AI 代理程式可透過 MCP 以
diagnose_connection和diagnose_network執行。請參閱找出某個網站或 API 連不上的原因。
常見問題
為什麼瀏覽器可以?
macOS 會信任管理員安裝的憑證。除非你加入檔案,否則 Node.js 使用它自己的清單。
設定 NODE_TLS_REJECT_UNAUTHORIZED=0 能解決問題嗎?
不能。它會關閉所有連線的憑證驗證。請改為加入 CA。
資料來源
查核日期:2026 年 10 月 29 日。