NFT元数据存储分链上、链下和混合三种方式:链上全部数据写入区块链确保不可篡改;链下仅存URI链接降低成本但存在失效风险;混合方案则关键字段上链、大文件链下引用并校验哈希。
币安注册链接与下载地址:
欧易OKX注册链接与下载地址:

NFT的元数据存储方式直接影响其可验证性与长期存续能力,链上与链下元数据在技术实现、成本结构和信任模型上存在本质差异。
一、链上元数据:全部数据写入区块链
链上元数据指NFT的图像文件、名称、描述、属性等全部内容均通过智能合约直接部署至区块链,每个字节都经过共识验证并永久存储于所有节点。这种方式确保元数据不可篡改、无需依赖第三方服务即可完整验证。
1、创作者使用Solidity编写支持内联SVG或Base64编码图像的ERC-721合约;
2、在合约构造函数中将JSON元数据结构硬编码进字节码;
3、调用mint函数时,图像哈希与原始字节一同写入交易日志;
4、用户通过eth_getStorageAt直接读取链上原始数据,无需外部请求。
二、链下元数据:仅存储指向内容的链接
链下元数据指NFT智能合约中仅保存一个URI(如IPFS CID或HTTP链接),实际图像与描述文件托管在区块链之外的系统中。该模式大幅降低Gas费用,但引入中心化托管或链接失效风险。
1、合约中tokenURI函数返回形如ipfs://QmXyZ...的CID地址;
2、该CID对应IPFS网络中托管的JSON文件,其中image字段为另一CID或URL;
3、用户需连接IPFS网关或中心化服务器才能加载图像;
4、若网关关闭或DNS被劫持,NFT将无法渲染原始内容。
三、混合元数据:关键字段上链,扩展内容链下
混合方案将所有权核心字段(如name、description、哈希值)写入链上,而大体积媒体文件(如高清视频、3D模型)通过去中心化协议引用。此方式平衡可信度与实用性。
1、在ERC-721合约中嵌入固定长度的SHA-256哈希值作为contentHash字段;
2、铸造时将该哈希与IPFS CID同时提交至链上事件日志;
3、前端应用先校验链上哈希是否匹配IPFS返回内容;
4、若校验失败,系统自动标记该NFT为内容异常状态。









