NFT画像が表示されない:メタデータとIPFSの経路を確認する

NFTの保有記録と画像は同じ場所に保存されているとは限りません。画像が見えない場合は、トークンの参照先、メタデータ、画像URI、表示用ゲートウェイを分けて確認します。

参照経路の確認表

コントラクト・token ID → 参照URI → メタデータ → image等のURI → 表示
段階確認
保有記録チェーン、コントラクト、token ID
メタデータURI、応答、JSONのimage等
画像ipfs://等のURI、CID、パス
表示ゲートウェイやアプリの応答と時刻

内容識別と可用性を分ける

IPFSのCIDは内容を識別しますが、永久に取得できるという保証ではありません。公式資料はpinning等による保存・提供の計画を説明しています。一つのゲートウェイの障害と、提供するノードが見つからない状態は別に調べます。

仮の切り分け例

JSONが読めてimageの参照先だけ応答しない例なら、どこまで読めたかを記録し、運営者へCID・パス・時刻を伝えます。署名を求める未知の復旧サイトへ接続する必要はありません。保有記録が残ることだけで画像を復元できると保証しません。

IPFSの資料には終了済みjs-ipfsの旧コードへの注意があります。ここでは参照と読取確認だけを扱い、旧コードを現行実装手順として載せません。

出典と確認範囲

個別適用や説明の拡張時に確認する事項:規格別のURI、可変データ、保存・提供状況と権利を個別確認。実NFTの復旧は未実施。