使用The Graph协议初始化子图时遭遇yarn依赖安装失败错误

环境信息 #

• npm 9.1.2
• yarn 3.2.3
• node 18.12.1（曾降级至v12.22.12）
• graph-cli 0.36.1

问题复现流程 #

执行graph init操作时：

• √ 成功从Etherscan获取ABI
• √ 设置合约名称为NftMarketplace
• √ 选择将合约事件索引为实体（true）
• √ 完成子图脚手架创建、网络配置初始化、子图仓库初始化
• × 依赖安装阶段触发错误：Command failed: yarn

报错详情：

C:\Users\User\AppData\Roaming\nvm\v14.17.0\node_modules\@graphprotocol\graph-cli\node_modules\gluegun\build\index.js:13  
    throw up;  
     ^

Error: Command failed: yarn
    at ChildProcess.exithandler (child_process.js:319:12)
    at ChildProcess.emit (events.js:376:20)
    at maybeClose (internal/child_process.js:1055:16)
    at Process.ChildProcess._handle.onexit (internal/child_process.js:288:5) {  
       killed: false,  
       code: 1,  
       signal: null,  
       cmd: 'yarn',  
       stderr: ''  
    }

解决办法 #

1. 强制用npm替代yarn安装依赖 #

graph-cli默认调用yarn，可手动指定npm绕过：

• 初始化时直接加--npm参数：

graph init --from-contract <你的合约地址> --network <目标网络> --npm

• 若已走到依赖安装失败环节，进入子图目录执行：

npm install

2. 降级yarn至v1.x经典版本 #

yarn 3.x的Berry版本与graph-cli存在兼容性问题：

• 全局安装yarn经典版：

npm install -g yarn@1.22.19

• 验证版本：

yarn --version

• 重新执行graph init流程

3. 清理缓存后重试 #

• 清理yarn缓存：

yarn cache clean

• 清理npm缓存：

npm cache clean --force

• 删除已生成的子图目录，重新执行初始化

4. 修复node版本环境 #

报错路径显示当前实际使用node v14.17.0，与你切换的版本不一致，需确保环境切换彻底：

• 用nvm切换到v14.17.0：

nvm use 14.17.0

• 验证版本：

node --version

• 重新执行graph init

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