Storybook安装报InvalidArgumentError错误的排查与解决方法求助

问题原因 #

该错误由node-fetch-native解析代理URL失败引发，与Node.js版本无关，重装Node.js无法解决。常见触发原因：

• 系统代理（Windows手动代理、第三方代理工具）配置了格式错误的URL，比如缺少http:///https://协议头、包含空格或特殊字符
• npm/yarn的proxy/https-proxy配置项存在无效URL
• 系统/用户环境变量中的HTTP_PROXY/HTTPS_PROXY设置了格式不正确的地址

解决办法 #

• 检查并修复系统代理
  打开Windows设置→网络和Internet→代理，查看手动代理地址：

  • 确保地址以http://或https://开头，无多余空格或非法字符
  • 无需代理时直接关闭手动代理，或暂时禁用第三方代理工具（如VPN）

• 重置npm代理配置
  打开CMD/PowerShell执行以下命令清除无效代理：

  npm config delete proxy
  npm config delete https-proxy
  

  如需重新配置代理，确认URL正确后执行：

  npm config set proxy http://有效代理地址:端口
  npm config set https-proxy http://有效代理地址:端口
  

• 清理环境变量中的代理设置
  右键此电脑→属性→高级系统设置→环境变量：

  • 查找系统/用户变量中的HTTP_PROXY、HTTPS_PROXY、ALL_PROXY
  • 删除值为无效URL的变量，或修改为正确的代理地址

• 清理npx缓存后重试安装
  执行命令清除npx缓存：

  npx clear-npx-cache
  

  重新运行Storybook安装命令：

  npx storybook@latest init
  

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