Solidity中带手续费代币兑换失败：UniswapV2 TRANSFER_FAILED错误排查

问题分析 #

你遇到的UniswapV2: TRANSFER_FAILED错误核心原因是目标手续费代币（0x535659CB81ad02f6b015050Df79E194F9eE66847）对合约接收有特殊限制，而你的合约未满足这些限制条件。主网网页能正常兑换是因为网页直接将代币转到EOA（外部账户），这类账户不受代币的合约接收限制；其他可正常兑换的合约则大概率提前适配了该代币的规则。

可能的具体限制及解决方案 #

1. 代币禁止非白名单合约接收

很多带反机器人机制的手续费代币会限制合约接收，仅允许EOA或白名单内的合约转账。你的合约不在白名单中，导致Uniswap Pair转代币到address(this)时被拒绝。

最快解决方案：修改兑换逻辑，直接将代币转到调用者的EOA地址（而非合约自身）：

address private constant WETH_ADDRESS = 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2;
address internal constant UNISWAP_ROUTER_ADDRESS = 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D;

function swapViaRouter(address tokenAddress) external payable {
    address[] memory path = new address[](2);
    path[0] = WETH_ADDRESS;
    path[1] = tokenAddress;

    // 将接收地址从address(this)改为msg.sender（调用者的EOA）
    IUniswapV2Router(UNISWAP_ROUTER_ADDRESS).swapExactETHForTokensSupportingFeeOnTransferTokens{
        value: msg.value
    }(0, path, msg.sender, block.timestamp + 150);
}

2. 代币要求合约实现特定接收接口

如果该代币是ERC777标准，或自定义了合约接收逻辑，未实现对应接口会导致转账回滚。比如ERC777要求接收合约实现IERC777Receiver接口。

解决方案：给你的合约添加对应接口实现：

import "@openzeppelin/contracts/token/ERC777/IERC777Receiver.sol";

contract SwapContract is IERC777Receiver {
    // ... 原有合约代码 ...

    function onReceived(
        address operator,
        address from,
        address to,
        uint256 amount,
        bytes calldata userData,
        bytes calldata operatorData
    ) external override returns (bytes4) {
        // 返回接口标识，满足代币的接收检查
        return this.onReceived.selector;
    }
}

如果是代币自定义的接口，需要先在Etherscan上查看该代币的合约代码，找到其要求的接口函数后再实现。

3. Gas不足导致转账失败

手续费代币的transfer函数通常包含额外逻辑（如手续费分发、反机器人检查），需要更多Gas才能完成。如果你的调用GasLimit设置过低，会导致转账中途失败。

解决方案：在调用swapViaRouter时提高GasLimit，比如前端调用时设置为300000或更高（可根据实际测试调整）。

验证建议 #

优先测试方案1，直接转至EOA，这是最快验证问题的方法；若必须让合约接收代币，再去Etherscan查看该代币的transfer函数逻辑，针对性适配规则。

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