执行truffle unbox metacoin操作下载失败，报ECONNREFUSED 0.0.0.0:443连接错误

复现操作步骤 #

• 创建项目存储目录：mkdir MetaCoin
• 进入已创建的项目目录：cd MetaCoin
• 执行模板拉取指令：truffle unbox metaicon

完整报错堆栈 #

Starting unbox...
=================

✔ Preparing to download box
✖ Downloading
Unbox failed!
✖ Downloading
Unbox failed!
RequestError: Error: connect ECONNREFUSED 0.0.0.0:443
    at new RequestError (/usr/local/lib/node_modules/truffle/build/webpack:/node_modules/request-promise-native/node_modules/request-promise-core/lib/errors.js:14:1)
    at Request.plumbing.callback (/usr/local/lib/node_modules/truffle/build/webpack:/node_modules/request-promise-native/node_modules/request-promise-core/lib/plumbing.js:87:1)
    at Request.RP$callback [as _callback] (/usr/local/lib/node_modules/truffle/build/webpack:/node_modules/request-promise-core/lib/plumbing.js:46:1)
    at self.callback (/usr/local/lib/node_modules/truffle/build/webpack:/node_modules/request/request.js:185:1)
    at Request.emit (events.js:311:20)
    at Request.onRequestError (/usr/local/lib/node_modules/truffle/build/webpack:/node_modules/request/request.js:881:1)
    at ClientRequest.emit (events.js:311:20)
    at TLSSocket.socketErrorListener (_http_client.js:426:9)
    at TLSSocket.emit (events.js:311:20)
    at emitErrorNT (internal/streams/destroy.js:92:8)
    at emitErrorAndCloseNT (internal/streams/destroy.js:60:3)
    at processTicksAndRejections (internal/process/task_queues.js:84:21)
Truffle v5.1.67 (core: 5.1.67)
Node v12.16.1

问题核心特征 #

报错触发在unbox流程的准备下载节点，抛出0.0.0.0:443地址的连接拒绝错误，直接中断整个模板拉取流程。

排查与解决方向 #

• 清理无效代理配置：Truffle v5.1.67底层依赖的请求库会自动读取环境变量与系统层面的代理配置，如果配置指向0.0.0.0:443这类无效地址，就会触发连接拒绝。可执行unset HTTP_PROXY HTTPS_PROXY http_proxy https_proxy清除无效代理变量后重试拉取指令。
• 修正模板指令拼写：官方MetaCoin模板的正确拉取指令为truffle unbox metacoin，当前输入的metaicon存在拼写偏差，会造成模板地址解析异常，间接引发下载地址指向错误的问题。
• 兜底拉取方案：如果网络问题持续无法解决，可直接获取对应版本的MetaCoin模板压缩包，解压到当前项目目录后手动安装依赖，绕过unbox命令的内置网络请求逻辑。

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