如何将IPFS存储的NFT元数据关联至ERC721合约？

智能合约不需要直接存储NFT图片，关联逻辑分三层：

• 第一层：单张NFT图片上传IPFS，每个图片生成独立CID
• 第二层：为每个NFT编写标准JSON格式元数据文件，元数据内填写对应图片的IPFS路径、NFT名称、描述、属性字段，每个元数据文件单独生成IPFS CID
• 第三层：合约为每个铸造出的tokenId返回对应元数据文件的访问URI，钱包、NFT交易平台等第三方服务会自动调用该接口拉取元数据，解析出图片地址完成展示。

OpenZeppelin ERC721实现中_baseURI和tokenURI的默认逻辑：

当_baseURI()返回非空值时，tokenURI(tokenId)会自动将baseURI和tokenId拼接，作为该代币的元数据URI返回。如果需要更灵活的URI映射逻辑，可以直接重写tokenURI方法覆盖默认实现。

针对IPFS上的多NFT藏品集合，有两种成熟实现方案：

方案1：单代币独立映射URI（适合元数据差异化大、无固定编号规则的藏品） #

逐个上传每个NFT的元数据文件拿到独立CID后，通过映射建立tokenId和对应元数据URI的关联，铸造时直接写入对应URI即可，不需要依赖_baseURI逻辑。
完整代码示例：

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;

import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/utils/Counters.sol";

contract MyToken is ERC721, Ownable {
    using Counters for Counters.Counter;

    Counters.Counter private _tokenIdCounter;
    // 存储每个tokenId对应的元数据IPFS地址
    mapping(uint256 => string) private _tokenURIs;

    constructor() ERC721("MyToken", "MTK") {}

    function safeMint(address to, string calldata metadataURI) public onlyOwner {
        uint256 tokenId = _tokenIdCounter.current();
        _tokenIdCounter.increment();
        _safeMint(to, tokenId);
        // 铸造时绑定对应元数据URI
        _tokenURIs[tokenId] = metadataURI;
    }

    // 重写tokenURI方法返回对应元数据地址
    function tokenURI(uint256 tokenId) public view override returns (string memory) {
        require(_exists(tokenId), "ERC721: query for nonexistent token");
        return _tokenURIs[tokenId];
    }
}

调用safeMint时传入的元数据URI需使用标准IPFS格式，例如ipfs://<元数据文件CID>

方案2：目录级baseURI配置（适合按tokenId顺序编号的系列藏品，Gas成本更低） #

如果将所有元数据文件按tokenId顺序命名为0、1、2……，再将整个元数据文件夹批量上传IPFS拿到目录CID，仅需配置一次baseURI即可自动为所有token生成对应元数据地址，不需要在铸造时额外写入URI，能大幅降低Gas消耗。
完整代码示例：

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.4;

import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
import "@openzeppelin/contracts/access/Ownable.sol";
import "@openzeppelin/contracts/utils/Counters.sol";

contract MyToken is ERC721, Ownable {
    using Counters for Counters.Counter;

    Counters.Counter private _tokenIdCounter;
    // IPFS元数据目录基础路径
    string private _baseTokenURI;

    constructor() ERC721("MyToken", "MTK") {}

    function safeMint(address to) public onlyOwner {
        uint256 tokenId = _tokenIdCounter.current();
        _tokenIdCounter.increment();
        _safeMint(to, tokenId);
    }

    // 管理员可配置/更新基础URI
    function setBaseURI(string calldata baseURI) external onlyOwner {
        _baseTokenURI = baseURI;
    }

    // 重写_baseURI返回配置的目录路径
    function _baseURI() internal view override returns (string memory) {
        return _baseTokenURI;
    }
}

配置baseURI时末尾必须加斜杠，例如ipfs://<元数据目录CID>/，合约拼接tokenId后才能正确定位到目录下的对应文件。例如tokenId=0的代币会自动返回ipfs://<目录CID>/0，和你上传的命名为0的元数据文件一一对应。

元数据格式注意事项 #

元数据JSON需遵循ERC721标准格式，image字段填写对应NFT图片的IPFS地址，示例结构：

{
  "name": "My NFT #0",
  "description": "First NFT of my collection",
  "image": "ipfs://<对应NFT图片的CID>",
  "attributes": [
    {"trait_type": "Rarity", "value": "Common"}
  ]
}

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