执行yarn install时遇证书链自签名证书错误求助

错误原因 #

这个错误是node-gyp在下载Node.js v16.14.0版本的头文件时，请求被拦截，系统检测到证书链中存在自签名证书。通常由公司内网代理、防火墙或本地安全软件替换了官方SSL证书导致。

解决方案 #

• 临时禁用证书校验（仅测试用，不推荐长期使用）
  通过设置环境变量跳过证书检查，执行对应命令后再重新安装：

  # Windows 命令提示符
  set NODE_TLS_REJECT_UNAUTHORIZED=0
  yarn install
  
  # Windows PowerShell
  $env:NODE_TLS_REJECT_UNAUTHORIZED=0
  yarn install
  
  # Linux/macOS
  NODE_TLS_REJECT_UNAUTHORIZED=0 yarn install
  

• 信任自签名证书
  获取内网代理或安全软件提供的根证书文件（.crt格式），通过环境变量让Node.js信任该证书：

  # Windows
  set NODE_EXTRA_CA_CERTS=C:\实际路径\证书文件.crt
  yarn install
  
  # Linux/macOS
  export NODE_EXTRA_CA_CERTS=/实际路径/证书文件.crt
  yarn install
  

• 配置node-gyp适配内网代理
  如果是内网代理导致证书问题，先配置npm的代理参数：

  # 设置基础代理
  npm config set proxy http://代理地址:端口
  npm config set https-proxy http://代理地址:端口
  
  # 代理需要认证时
  npm config set proxy http://用户名:密码@代理地址:端口
  npm config set https-proxy http://用户名:密码@代理地址:端口
  
  # 执行安装
  yarn install
  

• 手动下载头文件指定路径

  1. 手动从Node.js官方下载v16.14.0版本的头文件压缩包
  2. 解压后通过环境变量指定路径：

  # Windows
  set npm_config_nodedir=C:\解压后的头文件路径
  yarn install
  
  # Linux/macOS
  export npm_config_nodedir=/解压后的头文件路径
  yarn install
  

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