npm / bun

npm install 报 ECONNRESET 或证书错误

报错原文

npm ERR! request to https://registry.npmjs.org/xxx failed, reason: unable to get local issuer certificate

出现场景

公司网络、校园网或某些本地代理软件开启 HTTPS 检查时执行 npm/bun install 报证书或连接被重置。

可能原因(按概率)

1. 本地代理/防火墙对 HTTPS 做了中间人证书替换, Node 信任链里没有这个自签证书
2. npm 配置的 registry 或 proxy 地址本身不可达, 触发连接重置
3. Node.js 18+ 默认更严格的 TLS 校验, 老配置在新版本上不再兼容

修复步骤(从最简单的开始)

1. 先确认是否代理导致: npm config get proxy , 无代理需求就 npm config delete proxy 清掉残留配置
2. 改用国内镜像绕开证书拦截层: npm config set registry https://registry.npmmirror.com/
3. 确有自签证书需求, 把代理的 CA 证书导出后配置: npm config set cafile /path/to/proxy-ca.pem 或环境变量 export NODE_EXTRA_CA_CERTS=/path/to/proxy-ca.pem
4. 仅本地临时验证可用(不建议长期使用): npm config set strict-ssl false
5. bun 用户改用 bunfig.toml 里的 [install] ca 或 cafile 字段指定证书路径, bun 目前没有等价于 NODE_EXTRA_CA_CERTS 的全局变量