ERC721合约铸造NFT时元数据无法正常加载问题排查

问题概述 #

创建了一个ERC721合约，用户发送100 Wei即可铸造硬编码NFT，部署到Goerli测试网后，OpenSea测试网无法显示NFT图片。元数据通过标准铸造调用可正常工作，但在合约中无效。

合约代码 #

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
 
import "https://github.com/nibbstack/erc721/blob/master/src/contracts/tokens/nf-token-metadata.sol";
 
contract myNFT is NFTokenMetadata {

    uint tokenId = 0;

    string[] nfts = ["https://ipfs.io/ipfs/bafybeibnsoufr2renqzsh347nrx54wcubt5lgkeivez63xvivplfwhtpym/metadata.json"];
 
     function mint() public payable {
         require(msg.value == 100, "Send 100 Wei");
         super._mint(msg.sender, tokenId);
         super._setTokenUri(tokenId, nfts[0]);
         tokenId++;
    }
 
}

元数据内容 #

{"name":"No time to explain!","description":"I said there was no time to explain, and I stand by that.","image":"ipfs://bafybeidfjqmasnpu6z7gvn7l6wthdcyzxh5uystkky3xvutddbapchbopi/no-time-to-explain.jpeg"}

问题原因及修复方案 #

• 缺少公开的tokenURI方法：NFTokenMetadata内部的_setTokenUri会存储URI，但OpenSea需要通过公开的tokenURI(uint256)方法读取。添加以下代码到合约中：

  function tokenURI(uint256 _tokenId) public view override returns (string memory) {
      return super.tokenURI(_tokenId);
  }
  

  若原合约的tokenURI为internal，必须显式重写为public才能被外部平台调用。

• OpenSea缓存机制：测试网OpenSea会缓存元数据，即使合约修复，也需手动刷新：进入NFT详情页点击「Refresh metadata」，等待10-30分钟后查看。

• IPFS链接协议问题：部分平台对ipfs://协议的支持更稳定，可将合约中的URI改为：

  string[] nfts = ["ipfs://bafybeibnsoufr2renqzsh347nrx54wcubt5lgkeivez63xvivplfwhtpym/metadata.json"];
  

  先通过浏览器验证IPFS资源是否可正常访问。

• 接口支持缺失：检查supportsInterface是否正确返回ERC721Metadata的接口ID，若未实现，添加以下代码：

  bytes4 private constant _INTERFACE_ID_ERC721_METADATA = 0x5b5e139f;
  
  function supportsInterface(bytes4 interfaceId) public view override returns (bool) {
      return interfaceId == _INTERFACE_ID_ERC721_METADATA || super.supportsInterface(interfaceId);
  }
  

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