使用Metaplex SDK铸造NFT时名称随机缺失的调试求助

问题背景 #

使用Metaplex SDK铸造NFT时，出现部分NFT名称随机在区块链浏览器和元数据存储中缺失的情况，导致这类代币无法在Phantom钱包正常显示：

• 异常NFT mint地址：9SKg6LiT8suiyToATmQ6jjJxWqMcxcV7ALHcwmYSaoqY
• 正常NFT mint地址：F1qnUF2gPuf5FsD7whmacw1G7YFLaNHGYC48FAStmCjg

特殊现象：运行以下代码查询异常NFT时，返回的JSON对象内部包含名称"The Wreath"，但响应根节点的name字段为空：

const connection = new Connection(clusterApiUrl('mainnet-beta'));
const mx = Metaplex.make(connection);

const fetchNft = async () => {
  const asset = await mx
    .nfts()
    .findByMint({
      mintAddress: new PublicKey(
        '9SKg6LiT8suiyToATmQ6jjJxWqMcxcV7ALHcwmYSaoqY'
      ),
    })
    .run();

  console.log(asset);
};

调试思路 #

• 核对链上与离线元数据的一致性
  直接通过Solana RPC调用getAccountInfo查询NFT的元数据账户，对比返回内容和你上传到IPFS/Arweave的元数据文件：重点检查根节点name字段是否正确，同时确认元数据JSON格式无语法错误（比如多余逗号、引号不闭合）——格式错误会导致链上解析失败，但部分SDK可能会尝试修复解析，出现内部有值但根节点为空的情况。

• 排查铸造流程的异步时序问题
  Metaplex铸造时，元数据上传（到IPFS/Arweave）和链上交易是异步流程，可能出现元数据未完全上传完成，链上交易就已确认的情况。检查你的铸造代码是否等待元数据上传完成后再发送链上交易，是否有重试机制确保元数据可访问。

• 验证SDK版本与铸造配置
  确认使用的Metaplex SDK版本是否存在已知的元数据解析/铸造bug，尝试升级到最新稳定版。同时检查铸造时的参数配置，确认name字段在所有分支逻辑中都被正确赋值，没有被意外清空。

• 检查Phantom的元数据解析规则
  Phantom优先从链上元数据账户读取信息，再回退到外部存储。使用Phantom开发者工具查看它请求的元数据地址，对比返回内容是否符合Solana NFT元数据标准：比如name字段是否在顶层，字符串长度是否符合不超过32字节的要求。

• 对比正常与异常NFT的铸造日志
  拉取正常和异常NFT的全流程日志（链上交易日志、元数据上传日志），对比两者的执行差异：比如是否使用了不同的存储提供商、铸造时的gas设置是否不同、是否存在网络波动导致的步骤失败。

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