---
title: "Mac 上的“UNABLE_TO_GET_ISSUER_CERT_LOCALLY”· Kilobat 指南"
url: "https://kilobat.app/zh-hans/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-hans/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-hans/guides/corporate-proxy-certificates)。
- **私有机构。**公司的软件源或网关使用的证书来自 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-hans/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-hans/guides/npm-self-signed-cert-in-chain): SELF_SIGNED_CERT_IN_CHAIN 表示证书链中有一份证书不是由任何已知机构签发的。
- [Mac 上公司代理证书导致“终端”工具出错](https://kilobat.app/zh-hans/guides/corporate-proxy-certificates): 一些公司网络会检查 HTTPS 流量。
- [Mac 上的“curl: (60) SSL certificate problem”](https://kilobat.app/zh-hans/guides/curl-60-ssl-certificate-problem): curl 退出码 60 表示某个步骤失败。
- [Mac 上出现“npm error code ECONNRESET”](https://kilobat.app/zh-hans/guides/npm-econnreset): ECONNRESET 表示连接被强制重置。
