WordPressの移行後に画像が表示されない|URL・ファイル名・日本語文字の調査記録

WordPressの移行後に画像が表示されない|URL・ファイル名・日本語文字の調査記録

こんにちは。いっきー(@ikirin_web)です。

WordPress改ざんからの復旧シリーズ、4記事目です。シリーズ全体の流れと、前回の記事はこちらです。

前回は、XMLのURLを置換して本番環境へインポートするところまでまとめました。

インポートは終わったものの確認してみると、記事内の画像が一部表示されない、メディアの件数がLocalと合わないという問題が起きていました。今回は2つのサイト(サイトA・サイトB)で実際に起きたことと調べ方・対処をまとめます。

この記事は、私が実際に被害にあったときの対応をまとめた体験記です。被害の内容やサーバーの環境によって必要な対応は変わります。実際に対応するときは契約しているサーバー会社の案内を優先してください。

  1. 記事の画像が表示される仕組み
  2. 画像が表示されない原因を探すために3つを比較
  3. 足りないファイルと、本文に残ったuploads_old【サイトA】
  4. 旧ドメインのURLと、ファイル名の違いで表示されない【サイトB】
  5. メディアの件数差から見つかったNFD/NFCの問題【サイトB】
  6. uploads_oldを削除する

記事の画像が表示される仕組み

WordPressで記事の画像が表示される仕組みを説明します。

記事の本文はデータベースに保存されていて、その中に画像のURLが書かれています。

  1. WordPressがデータベースから記事の本文を取り出す
  2. 本文の中に<img src="https://example.com/wp-content/uploads/2025/07/sample.png">のような画像のURLがある
  3. ブラウザがそのURLに画像を取りに行く
  4. サーバーのwp-content/uploads/2025/07/sample.pngに実際のファイルがあれば、画像が表示される

記事の画像はメディアライブラリに登録されているから表示されるのではなく、本文に書かれたURLの先に実際のファイルがあるから表示されます。

一方のメディアライブラリは、uploadsにある実際のファイルとデータベース上の「この画像があります」という登録情報がセットになったものです。メディアの件数が合わないことと記事の画像が表示されないことは別の問題として考える必要があります。

画像が表示されない原因を探すために3つを比較

画像が表示されない原因を探すために次の3つを比べました。

  • 本番にインポートしたXML:記事の本文が、どの画像のURLを参照しているか
  • 本番のuploads:インポート後に今どんな名前のファイルがあるか
  • 本番のuploads_old:バックアップから救い出した元の画像が元の名前で残っているか

画像の数が多く、目で1件ずつ比べるのは現実的ではありません。そこで本番のuploadsとuploads_oldをFTPで手元にコピーし、XMLと一緒にAIツール(Codex)に読み取り専用で照合してもらい、出てきた結果を自分で確認しながら進めました。

AIツールの照合結果だけで追加・削除を決めず、対象のパスや実ファイルを確認しました。ファイルを補完したあとは、本番でも画像が表示されるかをチェックしています。

調査はファイルやデータベースを読み取るだけにして書き換えはしません。データベースを書き換える作業に入る前には必ず本番のデータベースのバックアップを取っておきます。

足りないファイルと本文に残ったuploads_old【サイトA】

サイトAは前回の記事で書いた「XML全体をuploads_oldに一括置換してしまった」サイトです。

起きていたこと

インポート後に確認すると次のような状態でした。

  • メディアの件数がLocalより24件少ない
  • 記事の本文にuploads_oldのURLが残っている
  • uploadsとuploads_oldの中身に差がある

足りないファイルを補完する

照合の結果、記事の本文などから必要とされているのにuploadsに実際のファイルがない画像が見つかりました。

  1. 不足している画像だけを集めた補完用のフォルダを作る
  2. FTPで補完用フォルダの中身を本番のuploadsにアップロードする
  3. アップロード後のuploadsを手元にコピーし直し、もう一度照合して、すべて置かれたかを確認する

この結果、不足していた227件のファイルをuploadsに補完できました。

メディアの24件差と不足していた227件は別のものです。24件はメディアの登録(データベース側)の件数の差で、227件は記事が参照しているのにuploadsになかった実際のファイルの数です。

メディアの24件差を調べる

24件差については本番とLocalのそれぞれで、メディアとして登録されている画像の一覧をCSVで書き出し照合しました。

その結果、24件はXMLの中に添付ファイルとして残っていたものの記事本文とアイキャッチでは使われていませんでした。今回は調査結果を確認し復旧対象に含めないと判断しました。

ただし、本文やアイキャッチ以外にもテーマ設定やカスタムフィールドなどから画像を参照している場合があります。使われていないかを判断するときはサイトの構成に合わせた確認が必要です。

本文のuploads_oldをuploadsに戻す

最後に記事の本文に残っていたuploads_oldのURLをuploadsに戻しました。

  1. 本番のデータベースのバックアップを取る
  2. Better Search Replaceで検索に/wp-content/uploads_old/、置換に/wp-content/uploads/を入力する
  3. 対象のテーブルはwp_postsだけGUIDの置換はOFFにする
  4. ドライランとして実行するにチェックを入れたまま実行し対象の件数(279セル)を確認する
  5. ドライランの結果が意図した置換範囲であることを確認しチェックを外して実行する

Better Search Replaceで表示される件数はURLの出現回数ではなくセルの数です。1つの記事の本文に対象のURLが10個あっても、その記事の本文は1セルとして数えられます。

旧ドメインのURLとファイル名の違いで表示されない【サイトB】

起きていたこと

サイトBではインポート後に次のことが分かりました。

  • 記事内の画像が表示されずサーバー移転前の旧ドメインのURLを参照していた
  • uploads_oldとuploadsで画像のファイル名が微妙に違っていた
  • メディアの件数がLocalの1,984件に対して本番は1,980件で4件少なかった

旧ドメインはすでに解約していたので、そのURLの先には何もありません。

旧ドメインのURLがどこに残っているか確認する

まず、Better Search Replaceのドライランで旧ドメインがどこに何件残っているかを確認しました。結果は、wp_postsに176セル・wp_postmetaに16セルでした。

ドメインを直すだけでは表示されない

ここで問題になったのがファイル名の違いです。

  • 記事の本文が参照している名前:sample-1024x589.png
  • 本番のuploadsにあるファイル:sample-scaled-1-1024x589.png

インポーターで画像を取り込み直したときに、-scaledや-1などが付いた名前で登録されていました。そのため記事の本文の旧ドメインを今のドメインに変えるだけでは、その名前のファイルがuploadsにないので画像は表示されません。

足りないファイルを補完する

照合の結果、旧ドメインで参照されていた画像のうち185件について次のことが確認できました。

  • uploadsには、同じフォルダ・同じ名前のファイルがない
  • uploads_oldには、同じフォルダ・同じ名前のファイルがある

そこで、この185件だけをuploadsに補完しました。

  1. 185件をuploadsに追加しても既存のファイルを上書きしないことを確認する
  2. 185件だけを集めた補完用のフォルダを作る
  3. FTPで補完用フォルダの中身を本番のuploadsにアップロードする
  4. 問題になっていたファイルが本番のuploadsの該当フォルダにあることを確認する

インポーターが作った似た名前の画像には手を付けず、記事が昔から参照していた元の名前のファイルだけを穴埋めするイメージです。メディアの登録が増えるわけではなくuploadsの実際のファイルが185個増えるだけです。

wp_postmetaの中身を確認する

補完が終わったら旧ドメインを置換します。ただwp_postmetaの16セルは、まとめて置換する前に中身を確認しました。phpMyAdminで調べると内訳は次のとおりでした。

  • メニューのリンク(_menu_item_url):2件
  • 埋め込みのキャッシュ(_oembed_):14件

_oembed_は、YouTubeなどを埋め込んだときにWordPressが保存するキャッシュで投稿の本体のデータではありません。

「これは何のデータか」を確認してから直す・消すを決めました。メニューのリンクは今のドメインに直しキャッシュは書き換えるのではなく削除しています。

旧ドメインを置換する

置換前に本番のデータベースのバックアップを取りました。

Better Search Replaceの検索欄には旧ドメイン名、置換欄には現在のドメイン名を入力しました。

  1. Better Search Replaceで、対象をwp_postsだけにしてドライランを実行し176セルになることを確認する
  2. ドライランのチェックを外して実行する
  3. 記事を開いて画像が表示されていることを確認する
  4. メニューのリンク2件はBetter Search Replaceでは対象を絞れないので管理画面の 外観 → メニュー から手で直す
  5. _oembed_の14件はphpMyAdminで件数を確認してから削除する

置換には取り消し機能がないためドライランで対象を確認してから実行しましょう。

メディアの件数差から見つかったNFD/NFCの問題【サイトB】

4件の差を、ファイルのパスで比べる

サイトBのメディアの4件差を調べるため、本番とLocalのそれぞれでメディアとして登録されている、画像のパスの一覧をCSVで書き出し照合しました。

IDではなくパスで比べたのは、本番はインポートで入れ直しているのでLocalとはIDが同じとは限らないからです。

照合すると大量の差分が出ましたが、そのほとんどは次のようなもので実際には同じ画像でした。

  • インポートで付いた-1、-scaled、-scaled-1
  • 日本語ファイル名の、NFDとNFCの違い

ファイル名の表記の違いを考慮して比較し、差分として残った画像を個別に確認すると本当にLocalにしかないものは4件でした。調べたところ、旧データの時点で登録情報がおかしかったもの、同じ画像が二重に登録されていたもの、記事では別の形式の画像を使っていたもので、どれも復元は不要でした。

大事なのはメディアの件数をLocalとぴったり合わせることではなく、記事・画像・アイキャッチなど必要なものが本番で正しく表示されていることです。

見た目は同じでも中身が違う文字

この照合の途中で別の問題に気づきました。

日本語の「ピ」は見た目が同じでも文字コード上は「ピ」1つで表す方法と、「ヒ」に半濁点を組み合わせて表す方法があります。

今回の画像ファイル名では、このUnicode正規化形式の違いであるNFCとNFDが本文のURLと実ファイルの間で食い違っていました。

照合の結果、LocalではNFDだったファイル名が本番ではNFCになっている画像が67枚ありました。そして記事の本文はNFDのファイル名を参照したままだったため、一部の画像が表示されていませんでした。

本番の記事の本文では29記事・67画像(76か所)で、この問題が起きていました。

一括置換せず管理画面から記事ごとに直した

データベースの書き換えが必要になると考え、まず本番のデータベースのバックアップを取りました。

ただ、直す対象は記事の本文の中にある画像のURLでした。そこで、Better Search Replaceで一括置換するよりも管理画面から記事ごとに直したほうが確実だと判断しました。

  1. ChatGPTに、NFDとNFCのファイル名の対応表を出してもらう
  2. まず1つの画像のパスを差し替えて、表示されることを確認する
  3. Classic Editorをインストール・有効化する
  4. 対象の記事を開き、対応表をもとに該当の画像URLを検索して書き換える
  5. 1記事直すたびに、画像が表示されたかを確認する

手作業にはなりましたが対応表があったので、該当のURLを検索して書き換えるだけで済みました。今回は29記事が対象で修正するURLの対応表も用意できたため、記事ごとに直して表示を確認する方法を選びました。

※Classic Editorは、今回の対象記事の編集方法に合わせて使用しました。画像URLの修正に必須のプラグインではありません。

uploads_oldを削除する

サイトAでは本文のuploads_oldのURLをuploadsに置換し終えてから、uploads_oldを削除しました。

uploads_oldを削除する前に記事本文だけでなくカスタムフィールドやテーマ設定など今回確認した範囲に参照が残っていないことを確認しました。画像の補完や表示確認が終わってから一時フォルダを削除しています。

まとめ

この記事では、インポート後に画像が表示されなかった原因と対処をまとめました。

  • 記事の画像はURLの先に実際のファイルがあるから表示される
  • 本文が参照する画像・今あるuploads・元のuploads_oldの3つを比べて原因を探す
  • 足りないファイルは上書きしないことを確認してから補完する
  • データベースの置換はバックアップとドライランをしてから行い対象のデータの中身も確認する
  • メディアの件数はぴったり合わせることより必要なものが表示されているかを優先する

次の記事ではテーマや設定を整え、プラグインを入れ直してセキュリティを強化するまでをまとめます。

最後まで読んでいただきありがとうございます。

ページトップへ戻る