运行PyG官方GCN示例报scatter_add()参数数量错误如何修复

报错核心是PyTorch Geometric（简称PyG）主包和配套依赖库版本严重不匹配：

• 你当前安装的torch-geometric==1.3.2是2019年发布的老旧版本，内部调用scatter_add时遵循旧版入参规范，会传入6个位置参数
• 但你安装的torch-scatter==2.0.9是较新版本，scatter_add函数已经调整了入参逻辑，最多只接收5个位置参数，直接触发参数数量不匹配的报错
• 另外你运行的官方示例是适配PyG 2.x版本的，就算临时解决了scatter的报错，后续也会因为API差异触发其他运行错误。

推荐直接把PyG主包升级到和当前PyTorch 1.11、其他依赖包匹配的版本，不需要修改示例代码：

1. 先卸载所有存在版本冲突的PyG相关包

pip uninstall -y torch-geometric torch-scatter torch-sparse torch-cluster

2. 安装版本对齐的稳定包组合

pip install torch-scatter==2.0.9 torch-sparse==0.6.13 torch-cluster==1.6.0 torch-geometric==2.0.4

这组版本是官方适配PyTorch 1.11的稳定组合，安装完成后直接运行原代码即可正常训练GCN模型。

如果因为特殊原因必须保留torch-geometric==1.3.2，就把torch-scatter降级到适配旧版PyG的版本：

pip install torch-scatter==2.0.4

注意这个方案需要你手动修改示例代码里所有不兼容1.3.2版本的API，比如DataLoader导入路径、部分图数据属性的调用方法，否则会出现其他报错，不建议使用。

安装完成后可以运行以下代码确认版本匹配：

import torch
import torch_geometric
import torch_scatter

print(f"PyTorch版本: {torch.__version__}")
print(f"PyG版本: {torch_geometric.__version__}")
print(f"torch-scatter版本: {torch_scatter.__version__}")

只要PyG版本在2.0.0及以上，和当前PyTorch 1.11搭配运行就不会再出现本次的scatter参数报错。

注意：PyG的扩展包（torch-scatter、torch-sparse、torch-cluster）和主包、PyTorch版本必须严格对应，跨大版本混装基本都会出现接口不兼容问题。

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