使用web3py调用Solidity合约公共变量报500错误如何排查

使用Python web3库调用Solidity智能合约的公共变量时调用失败，接口返回500 (Internal Server Error)。

• 智能合约片段（Solidity 0.8.7）：

pragma solidity ^0.8.7;
...
contract TestNFT is ERC721Enumerable, Ownable, Pausable {
...
   mapping(uint => bool) public locked;
...
}

• Python接口代码（Django）：

代码中fashionItemAddress与abi已在开头定义，确认可正常使用。

@api_view(['POST'])
def sendTxHashUndress(request):
    transaction_hash = request.POST["transaction_hash"]

    INFURA_URL = "https://rinkeby.infura.io/v3/9eda0366d20f4627860299a5ac514808"
    web3 = Web3(Web3.HTTPProvider(INFURA_URL))
    fContract = web3.eth.contract(fashionItemAddress, abi=ABI)
    print(fContract, '2222222222222')
    print(fContract.call().locked(), '==============')
    try:
        receiptments = web3.eth.wait_for_transaction_receipt(transaction_hash, 120, 0.1)
        print("receiptments", receiptments.status)
        if receiptments.status == 1:
            return _undressIcongirl(request)

        return JsonResponse({'result': 'failed_transaction'})
    except Exception as error:
        print(str(error))
        return JsonResponse({'result': str(error)})

0xe0ffc7d34f98803e7744cc587f80df19e93a010a760f7af1253c1405ff2faded 11111111
<web3._utils.datatypes.Contract object at 0x0000024679478A60> 2222222222222
[28/Jun/2022 18:47:53] "POST /api/sendTxHashUndress HTTP/1.1" 500 145

首先排除合约实例初始化问题：控制台能正常打印Contract对象，说明fContract实例创建成功，错误出在fContract.call().locked()这行调用，存在两个核心错误：

1. 合约调用规则错误：Solidity中public修饰的mapping类型，自动生成的getter函数必须传入mapping的key作为参数才能查询对应value。你定义的是mapping(uint => bool) public locked，对应的getter需要传入uint类型的key（一般是NFT的tokenId），无参调用必然报错。
2. Web3.py写法错误：Web3.py 读取合约状态的标准写法是合约实例.functions.方法名(参数).call()，你用的fContract.call().locked()是错误写法，不存在这种调用路径。

修复代码示例 #

把错误的调用行替换为标准写法，传入你要查询的uint参数即可，比如查询tokenId为1的锁定状态：

# 替换为你实际需要查询的uint类型key值
query_token_id = 1
lock_status = fContract.functions.locked(query_token_id).call()
print(lock_status, '==============')

额外排查建议 #

• 你当前代码把locked调用放在try块外，异常没有被捕获才会直接抛500，把这类合约调用移到try块内就能直接打印具体错误信息，无需靠猜测定位问题。
• Rinkeby测试网已正式弃用，建议将RPC节点切换到Sepolia测试网，避免节点服务不可用导致的额外问题。
• 确认使用的ABI中包含locked(uint256)方法的定义，ABI缺失也会导致调用失败。

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