Mac 上 npm 中的“SELF_SIGNED_CERT_IN_CHAIN”

SELF_SIGNED_CERT_IN_CHAIN 表示证书链中有一份证书不是由任何已知机构签发的。在工作网络中,通常是检查 TLS 的代理造成的。

让你的智能体来解决拷贝一条提示词,适用于 Claude Code、Codex 或任何能使用终端的智能体。

我的 Mac 出现了这个问题:Mac 上 npm 中的“SELF_SIGNED_CERT_IN_CHAIN”。请阅读 https://kilobat.app/zh-hans/guides/npm-self-signed-cert-in-chain.md,并和我一起逐步处理。如果缺少 Kilobat CLI,请安装:brew install seifip/kilobat/kilobat。请你自己运行指南中的终端和 kilobat 检查,并告诉我发现了什么。列出只有我才能完成的步骤。更改任何设置之前先问我。

适用于:所有当前 macOS 版本上的 npm。这个错误也会出现在其他 Node.js 工具中。核查日期:2026年10月29日

症状

  • npm install 中止并显示 npm error code SELF_SIGNED_CERT_IN_CHAIN。
  • 消息是 self-signed certificate in certificate chain。
  • 从连上公司网络或安装安全类 App 之后开始出现。

可能的原因

  • 检查 TLS 的代理。代理用它自己的证书替换了软件源的证书。参见企业代理证书会让 Mac 上的终端工具出错。
  • 扫描 HTTPS 的安全类 App。它可能会给流量加上它自己的根证书。
  • npm 太旧。npm 常见错误页面说明,npm 不再支持它以前使用的自签名证书。
  • 私有软件源。使用私有机构的软件源需要该机构的证书。

如何检查

  1. 查看软件源证书的签发者。

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

    npm config get cafile
  3. 检查 npm 版本。

    npm --version
  4. 试试手机热点。如果能用,说明第一个网络在检查 TLS。

如何修复

  1. 向网络管理员索取 PEM 格式的根证书。

  2. 让 npm 指向它。

    npm config set cafile /path/to/ca.pem
  3. 如果 npm 太旧,请更新。

    npm install npm -g
  4. 不要把 strict-ssl 设为 false。npm 文档不建议这样做。

使用 Kilobat

  1. Kilobat 的连接诊断会逐层测试软件源。TLS 层会显示这台 Mac 不信任的证书。

    kilobat why https://registry.npmjs.org/
  2. Kilobat 的这些检查都是免费的。AI 智能体可以通过 MCP 用 diagnose_connection 和 diagnose_network 运行它们。请参阅找出某个网站或 API 连不上的原因。

常见问题

npm config set strict-ssl false 安全吗?

它会关闭证书检查。对于代理造成的错误,npm 文档不建议这样做。请改为添加代理的 CA。

为什么这个错误只在工作时出现?

检查 TLS 的代理用它自己的证书对流量签名,而你的 Mac 不信任它。

参考资料

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