Solidity可升级/代理合约实现中函数重载不生效问题

该猜想不成立，问题和Truffle的可升级合约运行机制、OpenZeppelin升级合约的链上逻辑均无关系。

问题根源说明 #

1. EVM层面本身完全支持Solidity函数重载：定义的example()和example(uint256)会生成完全不同的4字节函数选择器，不管是普通合约的直接调用，还是可升级合约的代理delegatecall路由，都能准确识别并执行对应函数，不存在链上层面的执行冲突。
2. 带参函数无法触发的问题出在测试脚本的JS调用层：Truffle默认集成web3.js作为链交互库，而web3.js的合约实例默认不会根据传入参数自动匹配同名重载函数——当ABI中存在多个同名不同参的函数时，直接用合约实例.example(传参)的写法，会固定匹配ABI里排序靠前的无参example()，编码生成的calldata始终对应无参版本的选择器，自然永远不会执行带参的逻辑。
3. 重命名为example1后能正常调用，本质是因为消除了同名函数冲突，web3.js可以直接匹配到唯一的函数定义生成正确calldata，这个现象和可升级合约能力完全无关：就算部署的是普通非升级合约，在Truffle测试里直接调用同名重载函数，也会出现完全一致的问题。

解决方法 #

不需要修改函数名，调用重载函数时显式指定完整函数签名定位目标方法即可，注意Solidity中uint是uint256的别名，签名里必须写uint256，示例代码：

// 错误写法：只会匹配无参版本的example
await contractInstance.example(123, { from: user });

// 正确写法：显式指定带参版本的完整签名
await contractInstance.methods['example(uint256)'](123).send({ from: user });

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