Web3.py调用Uniswap V2的swapExactETHForTokens时buildTransaction方法报错问题

你遇到的这个'swapExactETHForTokens(...)' object has no attribute 'buildTransaction'错误，确实大概率和ABI的加载或者代码细节有关，咱们一步步拆解排查：

原因1：ABI文件格式错误或不完整 #

你说从Etherscan下载了Uniswap V2 Router的ABI，但有时候直接复制的全量ABI可能会有格式问题（比如多余的转义符、括号缺失），或者你保存的abi.json没有正确存为JSON格式，导致web3.py无法正确解析出函数对象。

解决办法： #

• 先校验abi.json的有效性：在本地用Python测试加载，确保没有抛出JSON解析异常：

  import json
  with open('abi.json', 'r') as f:
      try:
          abi = json.load(f)
          print("ABI加载成功")
      except json.JSONDecodeError as e:
          print(f"ABI格式错误：{e}")
  

• 或者直接用精简版ABI：只保留swapExactETHForTokens相关的ABI片段，减少出错概率，替换你的abi.json内容为：

  [
    {
      "inputs": [
        {"internalType": "uint256", "name": "amountOutMin", "type": "uint256"},
        {"internalType": "address[]", "name": "path", "type": "address[]"},
        {"internalType": "address", "name": "to", "type": "address"},
        {"internalType": "uint256", "name": "deadline", "type": "uint256"}
      ],
      "name": "swapExactETHForTokens",
      "outputs": [{"internalType": "uint256[]", "name": "amounts", "type": "uint256[]"}],
      "stateMutability": "payable",
      "type": "function"
    }
  ]
  

原因2：代码中未定义path变量 #

看你的函数代码，调用swapExactETHForTokens时用到了path参数，但你的函数参数里只有token_in和token_out，完全没定义path变量！这种参数缺失会导致web3.py无法正确生成合法的函数调用对象，间接触发属性不存在的错误。

解决办法： #

Uniswap V2的swapExactETHForTokens要求path是从WETH到目标代币的地址数组（因为ETH在Uniswap里是用WETH映射的），所以在调用函数前先构建path：

# 先定义WETH的主网地址
WETH_ADDRESS = "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
# 构建路径：ETH -> 目标代币，对应WETH地址 + 目标代币地址
path = [WETH_ADDRESS, token_out]

原因3：Web3实例未正确初始化 #

你的代码里用了web3.eth.contract，但我没看到你初始化Web3实例的代码！如果web3对象没连接到Infura节点，后续的合约对象创建会异常，也会引发这类错误。

解决办法： #

在代码最顶部或者函数内初始化Web3实例：

load_dotenv()
# 从.env读取你的Infura项目ID
infura_url = f"https://mainnet.infura.io/v3/{os.getenv('INFURA_PROJECT_ID')}"
web3 = Web3(Web3.HTTPProvider(infura_url))
# 验证网络连接
assert web3.is_connected(), "Failed to connect to Ethereum network via Infura"

原因4：Gas参数设置混淆 #

你的代码里写了'gas': max_gas_price，这里max_gas_price应该是Gas数量（比如200000），而gasPrice是Gas单价（比如web3.to_wei(20, 'gwei')），如果参数搞混了，也可能间接导致buildTransaction失败。

解决办法： #

修正Gas相关参数：

'gas': 200000,  # 合理的Gas上限，可根据实际调整
'gasPrice': web3.eth.gas_price,  # 直接用当前网络的Gas单价

快速测试步骤 #

先单独测试ABI加载和合约函数是否能被识别：

# 初始化Web3后执行这段
with open('abi.json', 'r') as f:
    abi = json.load(f)
router_contract = web3.eth.contract(
    address="0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D",
    abi=abi
)
# 打印所有可用函数，确认swapExactETHForTokens存在
available_functions = [func.fn_name for func in router_contract.functions]
print(f"可用函数：{available_functions}")
if 'swapExactETHForTokens' in available_functions:
    print("swapExactETHForTokens函数识别成功！")
else:
    print("函数未识别，ABI肯定有问题！")

另外你提到用transact()不行，这个是对的——Infura不支持解锁账户，所以必须用buildTransaction()+本地签名的方式，你的这个思路完全正确，不用怀疑这点。

备注：内容来源于stack exchange，提问作者Benjamin Payson