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 上的终端工具出错。
  • 私有机构。公司的软件源或网关使用的证书来自 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 连不上的原因。

常见问题

为什么浏览器能正常工作?

macOS 信任管理员安装的证书。除非你添加一个文件,否则 Node.js 使用它自己的列表。

设置 NODE_TLS_REJECT_UNAUTHORIZED=0 能解决问题吗?

不能。它会对每个连接关闭证书验证。请改为添加 CA。

参考资料

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