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 检查,并告诉我发现了什么。列出只有我才能完成的步骤。更改任何设置之前先问我。
症状
npm install中止并显示npm error code SELF_SIGNED_CERT_IN_CHAIN。- 消息是
self-signed certificate in certificate chain。 - 从连上公司网络或安装安全类 App 之后开始出现。
可能的原因
- 检查 TLS 的代理。代理用它自己的证书替换了软件源的证书。参见企业代理证书会让 Mac 上的终端工具出错。
- 扫描 HTTPS 的安全类 App。它可能会给流量加上它自己的根证书。
- npm 太旧。npm 常见错误页面说明,npm 不再支持它以前使用的自签名证书。
- 私有软件源。使用私有机构的软件源需要该机构的证书。
如何检查
查看软件源证书的签发者。
curl -v -o /dev/null https://registry.npmjs.org/ 2>&1 | grep -i issuer显示 npm 使用的 CA 文件。
npm config get cafile检查 npm 版本。
npm --version试试手机热点。如果能用,说明第一个网络在检查 TLS。
如何修复
向网络管理员索取 PEM 格式的根证书。
让 npm 指向它。
npm config set cafile /path/to/ca.pem如果 npm 太旧,请更新。
npm install npm -g不要把
strict-ssl设为 false。npm 文档不建议这样做。
使用 Kilobat
Kilobat 的连接诊断会逐层测试软件源。TLS 层会显示这台 Mac 不信任的证书。
kilobat why https://registry.npmjs.org/Kilobat 的这些检查都是免费的。AI 智能体可以通过 MCP 用
diagnose_connection和diagnose_network运行它们。请参阅找出某个网站或 API 连不上的原因。
常见问题
npm config set strict-ssl false 安全吗?
它会关闭证书检查。对于代理造成的错误,npm 文档不建议这样做。请改为添加代理的 CA。
为什么这个错误只在工作时出现?
检查 TLS 的代理用它自己的证书对流量签名,而你的 Mac 不信任它。
参考资料
核查日期:2026 年 10 月 29 日。