トラブル対応

公開日:

更新日:

WordPressが真っ白になったときの原因と確認手順

WordPressが真っ白になった場合に、影響範囲、直前の変更、PHPエラーを確認し、プラグインやテーマを一つずつ切り分ける手順を解説します。

まず公開画面と管理画面の状態を分ける

WordPressが真っ白になったら、公開ページだけか、/wp-admin/も開けないかを確認します。特定ページだけなら、そのページで使うテンプレートやプラグインへ範囲を絞れます。サイト全体と管理画面が同時に表示されない場合は、共通して読み込まれるプラグイン、テーマ、PHPエラーを先に疑います。

WordPress真っ白画面の初動確認フロー

画面を戻そうとして複数の更新や設定変更を重ねると、原因になった変更が分からなくなります。発生時刻、表示された文言、直前に更新した製品や編集したファイルを先に記録します。

復旧モードとエラーログから原因を読む

WordPressが致命的なPHPエラーを検知すると、管理者メールアドレスへ復旧モードの案内を送ることがあります。メールにはエラーを起こしたプラグインやテーマが表示されるため、届いていればリンクから管理画面へ入り、対象を停止できます。

メールがない場合はサーバーのPHPエラーログを確認します。ファイルパス、行番号、Fatal errorの直後にある内容から、どのコードを実行した時点で止まったかを見ます。真っ白という見た目だけでは原因を特定できません。

ログを取れない環境では、wp-config.phpにあるdefine( 'WP_DEBUG', false );を次の設定へ置き換え、/* That's all, stop editing! Happy publishing. */より上へ置きます。

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

エラーはwp-content/debug.logへ記録されます。公開画面へ詳細を表示するとファイルパスなどが利用者にも見えるため、WP_DEBUG_DISPLAYはfalseにし、確認後はデバッグ設定を元へ戻します。

プラグインとテーマを一つずつ切り分ける

管理画面へ入れる場合は、直前に更新または有効化したプラグインから停止します。表示が戻ったら、そのプラグインが単独で原因なのか、別製品との組み合わせなのかをログと変更履歴で確認します。

管理画面へ入れない場合は、SFTPやサーバーのファイル管理から対象ディレクトリ名を変えると、WordPressがプラグインを読み込めなくなります。

wp-content/plugins/example-plugin
wp-content/plugins/example-plugin-disabled

対象が分からなければplugins全体を一時的に改名し、表示が戻るか確認します。戻った場合は元の名前へ戻したあと、個別のプラグインを順に有効化します。全部を停止したままでは、どれが原因だったか分からないからです。

プラグインで変化がなければ、テーマをWordPress公式の標準テーマへ切り替えます。管理画面へ入れない場合は現在のテーマディレクトリを改名しますが、標準テーマがインストールされていなければ自動では切り替わりません。

プラグインとテーマを切り分ける復旧手順

メモリ不足はログに出た場合に確認する

ログにAllowed memory size exhaustedとあれば、PHPが使えるメモリを超えています。上限を増やす前に、どの処理で大量に使っているかを確認します。無限ループや重い処理が原因なら、上限だけを増やしても再発します。

原因となった更新やコードを戻し、同じ操作でエラーが出ないこと、公開ページと管理画面が開くことを確認します。

関連記事

WordPress Monitoring

複数サイトの監視を自動化しませんか?

死活監視・Fatal Error・SSL期限・更新検知をまとめて管理。3サイトまで無料で始められます。

この記事を書いた人

uehiro
uehiroWebアプリケーションエンジニア

2019年よりWeb制作・システム開発に従事。WordPress・PowerCMS・Movable TypeのCMS構築・運用支援のほか、Next.js・Astro・Nuxt.jsを活用したヘッドレスCMS・モダンWeb開発に携わる。約150件の制作・運用支援実績を持ち、現在はWordPress監視サービス「NexraOne」の開発・運営を担当。