Node环境证书验证失败及npm包安装冻结问题求助

核心原因 #

出现UNABLE_TO_VERIFY_LEAF_SIGNATURE错误和安装包卡住的问题，本质是TLS证书链验证失败。通常由以下场景导致：

• 网络环境变更：公司代理、防火墙、VPN更新了证书规则，拦截HTTPS请求并替换证书，Node/NPM无法识别新的证书颁发机构（CA）
• Node版本兼容性：你使用的Node 21是非LTS版本，可能存在TLS证书验证逻辑的兼容性问题
• 缓存残留：npm缓存的旧证书或依赖信息引发验证冲突

安全的解决方案（不推荐关闭strict-ssl） #

1. 导入信任的CA证书 #

如果是代理/防火墙替换了证书，找到对应的根CA证书（格式为.pem/.crt），执行以下操作：

• 全局配置npm信任该证书：

  npm config set cafile "/绝对路径/your-ca-cert.pem" --global
  

• 或者给Node添加额外信任证书（全局生效）：
  • Linux/macOS：在~/.bashrc或~/.zshrc中添加：

    export NODE_EXTRA_CA_CERTS="/绝对路径/your-ca-cert.pem"
    

    执行source ~/.bashrc生效
  • Windows：在系统环境变量中添加NODE_EXTRA_CA_CERTS，值为证书的绝对路径，重启终端生效

2. 切换Node LTS版本 #

Node 21是短期支持版本，存在未知兼容性风险。切换到LTS版本（如18.x或20.x），可避免这类证书验证问题：

• 使用nvm切换：

  nvm install 20 --lts
  nvm use 20
  

3. 清理npm缓存 #

清除可能残留的旧证书或依赖缓存：

npm cache clean --force

关于strict-ssl false的安全性 #

关闭strict-ssl会跳过TLS证书验证，极大增加中间人攻击风险，攻击者可伪造npm包源，将恶意代码植入你的依赖中，绝对不建议在生产环境使用，开发环境也尽量用上述安全方案替代。

内容的提问来源于stack exchange，提问作者Gagik Navasatariyan