---
title: "Mac 上的 UNABLE_TO_GET_ISSUER_CERT_LOCALLY · Kilobat 指南"
url: "https://kilobat.app/zh-hant/guides/npm-unable-to-get-issuer-cert-locally"
description: "Mac 上的 Node.js 或 npm 以 UNABLE_TO_GET_ISSUER_CERT_LOCALLY 停止。憑證的簽發者不明。請加入正確的 CA 檔案，不要停用檢查。"
---

# 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 檢查，並告訴我發現了什麼。列出只有我才能完成的步驟。變更任何設定之前先問我。

適用於：所有目前 macOS 版本上的 Node.js、npm 和以 Node.js 建置的工具。 · 檢查日期：2026年10月29日

## 症狀

- 某個 Node.js 工具以 `UNABLE_TO_GET_ISSUER_CERT_LOCALLY` 停止。
- 訊息可能顯示 `unable to get local issuer certificate`。
- 瀏覽器可能打得開同一個網站。

## 可能原因

- **進行 TLS 檢查的代理伺服器。**公司代理伺服器用自己的憑證簽署流量。請參閱 [公司代理伺服器的憑證會讓 Mac 上的終端機工具失效](https://kilobat.app/zh-hant/guides/corporate-proxy-certificates)。
- **私有機構。**公司的 registry 或閘道使用 Node.js 不認得的機構所簽發的憑證。
- **掃描 HTTPS 的資安 App。**它加入了自己的根憑證，而 Node.js 預設不使用它。
- **缺少中繼憑證。**伺服器可能漏掉了部分憑證鏈。

## 如何檢查

1. 讀取簽發者。

   ```
   curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer
   ```
2. 顯示 npm 使用的 CA 檔案。

   ```
   npm config get cafile
   ```
3. 顯示 Node.js 的 CA 變數。

   ```
   echo $NODE_EXTRA_CA_CERTS
   ```
4. 試試手機熱點。

## 如何修正

1. 向網路管理員取得 PEM 格式的 CA 憑證。
2. 讓 Node.js 在這個 shell 中信任它。

   ```
   export NODE_EXTRA_CA_CERTS=/path/to/ca.pem
   ```
3. 對 npm，請設定同一個檔案。

   ```
   npm config set cafile /path/to/ca.pem
   ```
4. 請勿設定 `NODE_TLS_REJECT_UNAUTHORIZED=0`。它會關閉所有檢查。

## 使用 Kilobat

1. Kilobat 的連線診斷會逐層測試主機。TLS 層會顯示這部 Mac 不信任的憑證。

   ```
   kilobat why https://registry.npmjs.org/
   ```
2. 這些 Kilobat 檢查都是免費的。AI 代理程式可透過 MCP 以 `diagnose_connection` 和 `diagnose_network` 執行。請參閱[找出某個網站或 API 連不上的原因](https://kilobat.app/zh-hant/guides/recipes/why-cant-it-connect)。

## 常見問題

**為什麼瀏覽器可以？**

macOS 會信任管理員安裝的憑證。除非你加入檔案，否則 Node.js 使用它自己的清單。

**設定 NODE_TLS_REJECT_UNAUTHORIZED=0 能解決問題嗎？**

不能。它會關閉所有連線的憑證驗證。請改為加入 CA。

## 資料來源

- [npm 文件：常見錯誤](https://docs.npmjs.com/common-errors)
- [Claude Code：企業網路設定](https://code.claude.com/docs/en/network-config.md)

查核日期：2026 年 10 月 29 日。

## 相關指南

- [Mac 上 npm 的「SELF_SIGNED_CERT_IN_CHAIN」](https://kilobat.app/zh-hant/guides/npm-self-signed-cert-in-chain): SELF_SIGNED_CERT_IN_CHAIN 表示憑證鏈中有一張憑證，不是任何已知機構簽署的。
- [公司代理伺服器憑證導致 Mac 上的終端機工具失效](https://kilobat.app/zh-hant/guides/corporate-proxy-certificates): 有些公司網路會檢查 HTTPS 流量。
- [Mac 上的「curl: (60) SSL certificate problem」](https://kilobat.app/zh-hant/guides/curl-60-ssl-certificate-problem): curl 結束代碼 60 表示某個步驟失敗。
- [Mac 上的「npm error code ECONNRESET」](https://kilobat.app/zh-hant/guides/npm-econnreset): ECONNRESET 表示連線遭強制重設。
