Polygon Mumbai测试网NFT铸造DApp故障：交易成功钱包无NFT

1. 智能合约缺失NFT元数据接口（核心原因） #

你的ERC721合约未实现tokenURI或_baseURI方法，导致钱包无法获取NFT的元数据（图片、名称等信息），因此不会在钱包中显示NFT。

OpenZeppelin的ERC721默认tokenURI返回空字符串，需添加元数据相关实现：

// 在合约中添加基础URI方法，替换为你的元数据存储地址（如IPFS前缀）
function _baseURI() internal view override returns (string memory) {
    return "ipfs://your-metadata-folder/";
}

或者直接重写tokenURI自定义逻辑：

function tokenURI(uint256 tokenId) public view override returns (string memory) {
    _requireMinted(tokenId);
    return string(abi.encodePacked("ipfs://your-metadata-folder/", tokenId.toString(), ".json"));
}

注意：元数据文件需符合ERC721标准（包含name、description、image等字段），并上传至可访问的存储服务（如IPFS）。

2. 合约铸造逻辑的小缺陷 #

你的mint函数中，require(nextTokenId < MAX_NFTS)限制最多铸造9个NFT（nextTokenId从1开始，等于10时不满足<10），但声明的MAX_NFTS是10。若需铸造10个，应修改为：

require(nextTokenId <= MAX_NFTS, "Maximum number of NFTs minted");

3. 前端代码的错误 #

3.1 调用不存在的合约方法 #

前端代码中调用了contract.methods.tokenOfOwner(accounts[0]).call()，但你的合约未实现tokenOfOwner方法（OpenZeppelin ERC721默认也无此方法），导致获取已拥有NFT失败。

解决方式：要么在合约中自定义映射和获取方法：

mapping(address => uint256[]) public ownerToTokens;

// 在_safeMint后添加：
ownerToTokens[msg.sender].push(nextTokenId);

// 添加获取用户NFT的方法：
function tokenOfOwner(address owner) public view returns (uint256[] memory) {
    return ownerToTokens[owner];
}

要么改用ERC721Enumerable扩展合约，它提供tokenOfOwnerByIndex和balanceOf方法遍历用户NFT：

import "@openzeppelin/contracts/token/ERC721/extensions/ERC721Enumerable.sol";

contract MyNFTCollection is ERC721Enumerable, Ownable {
    // 其他代码不变
}

3.2 错误更新已拥有NFT列表 #

buyToken函数中将交易对象result添加到tokenOwned数组，而不是tokenId，导致前端显示的NFT数量错误。正确做法是从交易事件提取tokenId，或重新获取用户NFT列表：

const buyToken = async() => {
    try{
        const result = await contract.methods.mint().send({
            from: account,
            value: web3.utils.toWei("0.01", "ether"),
        });
        // 从Transfer事件中提取tokenId
        const tokenId = result.events.Transfer.returnValues.tokenId;
        setTokenOwned([...tokenOwned, tokenId]);
        // 或重新拉取用户的NFT列表
        const updatedTokens = await contract.methods.tokenOfOwner(account).call();
        setTokenOwned(updatedTokens);
    }catch(err){
        console.error(err);
    }
};

4. 钱包与链的验证步骤 #

• 确认Metamask已切换至Polygon Mumbai测试网，且连接账户正确。
• 前往Polygon Mumbai扫描器查看交易详情，确认Transfer事件已触发（钱包依赖此事件识别NFT）。
• 若链上已确认NFT存在但钱包未显示，手动在Metamask中导入NFT：输入合约地址和对应tokenId。

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