WordPress 画面が真っ白になる原因とWP_DEBUGでの調べ方
WordPress の画面が真っ白になったときの原因の切り分け手順を整理。WP_DEBUG と WP_DEBUG_LOG の設定、debug.log の読み方、メモリ不足やプラグイン・テーマの無効化、リカバリーモードまでを解説します。
結論
画面が真っ白(White Screen of Death)になるのは、ほとんどの場合 PHP の致命的エラーが起きていて、その表示が隠されている状態です。原因は、プラグイン・テーマのコードの誤り、PHP バージョンとの不整合、メモリ不足のいずれかであることが大半です。
対処の流れは次の通りです。
- バックアップを取る(
wp-config.phpを編集する前に必ず) wp-config.phpでWP_DEBUGとWP_DEBUG_LOGを有効にし、エラーの内容を見る- エラーに出たファイルのパスから、原因のプラグインかテーマを特定する
- そのプラグイン/テーマのフォルダ名を変更して無効化する
- 直ったら、更新・修正・代替を検討する
原因・仕組み
WordPress 5.2 以降には「リカバリーモード」(致命的エラー保護)があり、致命的エラーが起きると、画面には「このサイトで重大なエラーが発生しました。」(検証環境 7.1.2 の日本語訳。WordPress 5.2 当時の英語の文言は「The site is experiencing technical difficulties.」)というメッセージが出て、管理者宛にメールが届く仕組みがあります。その場合は、メールのリンクからリカバリーモードで入り、原因のプラグインを停止できます。
メールが届かない、または保護が働かない状況(wp-config.php の記述ミス、メモリ不足の途中で落ちた場合など)では、本当に何も表示されない白い画面になります。PHP の設定で display_errors がオフなので、エラーが画面に出ないのです。
公式ドキュメントによると、WP_DEBUG は WordPress の「デバッグモード」を有効にする定数で、WP_DEBUG_LOG を有効にすると、エラーが wp-content/debug.log に保存されます。WP_DEBUG_DISPLAY を false にすると、画面には出さず、ログだけに記録できます。
手順(サンプルコード)
wp-config.php の、/* That's all, stop editing! Happy blogging. */ の直前に書きます。
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // wp-content/debug.log に保存
define( 'WP_DEBUG_DISPLAY', false ); // 画面には出さない(公開中のサイトの場合)
@ini_set( 'display_errors', 0 );
再度ページを開き、wp-content/debug.log の最後の数行を確認します。典型的な出力は次のような形です。
PHP Fatal error: Uncaught Error: Call to undefined function my_missing_function() in /…/wp-content/plugins/foo/foo.php:4
パスの plugins/foo/ が原因のプラグインです。管理画面に入れない場合は、FTP などで wp-content/plugins/foo を foo.disabled のように名前変更します。テーマが原因なら wp-content/themes/ の該当フォルダ名を変えると、WordPress が既定のテーマに戻します。
メモリ不足が原因(Allowed memory size of ... bytes exhausted)の場合は、上限を引き上げます。
define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );
動作確認(検証環境と結果)
WordPress 7.1.2(ja)/PHP 8.2.12 で実行しました(tests フォルダの p8.php、p10.php)。
WP_DEBUG=true
WP_DEBUG_LOG=false
WP_DEBUG_DISPLAY=true
WP_MEMORY_LIMIT='40M'
wp_is_fatal_error_handler_enabled=true
before
PHP Fatal error: Uncaught Error: Call to undefined function my_missing_function() in ...p10.php:4
- 検証用スニペットで未定義関数を呼ぶと、
Fatal error: Uncaught Error: Call to undefined functionが出力され、その後の処理は実行されませんでした。これが、本番で画面が白くなる状態の元になる挙動です。 - 検証環境の
WP_MEMORY_LIMITは既定の40Mでした。公式ドキュメントも、単一サイトの既定値を40MBとしています。 - 致命的エラー保護(
wp_is_fatal_error_handler_enabled)は有効でした。 - 本番サーバーでの白い画面の再現、
debug.logへの実際の書き込み、メール送信は、この CLI 環境では確認していません。
WordPress 画面が真っ白になる原因とWP_DEBUGでの調べ方の注意点
- 公式ドキュメントは、
WP_DEBUGなどを公開中のサイトで有効にしないことを推奨しています。使うならWP_DEBUG_DISPLAYを false にして、調査後は元に戻します。 debug.logは URL でアクセスできる場所にあります。使用後は削除するか、アクセスを制限します。- 設定を書く位置を間違える(
stop editingより後)と、反映されません。 - 開発環境で画面に直接出したい場合は、
WP_DISABLE_FATAL_ERROR_HANDLERで保護機能を無効にできると、公式にあります。 - PHP のバージョンを上げた直後に白くなったときは、対応していない古いプラグインが原因の可能性が高いです。
WordPress 画面が真っ白になる原因とWP_DEBUGでの調べ方でよくあるミス
- 記述の最後の閉じ括弧や
;を落としてwp-config.php自体を壊す。 - すべてのプラグインを一度に停止し、原因が分からなくなる。1つずつ戻して特定します。
WP_DEBUG_DISPLAYが true のまま本番で公開し、パス情報を訪問者に見せてしまう。- メモリ上限を極端に大きくして問題を隠し、無限ループなどの根本原因を見逃す。
WordPress 画面が真っ白になる原因とWP_DEBUGでの調べ方のチェックリスト
- 作業前にファイルとデータベースのバックアップを取った
WP_DEBUG_LOGを有効にし、debug.logを見た- エラーのファイルパスから原因を特定した
- 調査後に
WP_DEBUGを元に戻した debug.logを削除または保護した
WordPress 画面が真っ白になる原因とWP_DEBUGでの調べ方のFAQ(よくある質問)
Q. 管理画面だけ白いときは。
A. 管理画面側だけで読み込まれるプラグインが原因のことが多く、メモリ上限(WP_MAX_MEMORY_LIMIT)も疑います。
Q. ログが空のままです。
A. wp-content に書き込み権限が無い、設定の位置が誤っている、PHP の設定でログ出力が止められている、などを確認します。
Q. 原因がテーマのとき、更新を戻せますか。
A. バックアップがあればその版に戻せます。無ければ、該当ファイルの該当行を修正します。
筆者の見解(WordPress 画面が真っ白になる原因とWP_DEBUGでの調べ方)
白い画面は慌てやすい状況ですが、「ログを出す、パスを見る、名前を変える」の3手でかなりの割合を切り分けられると考えています。私見では、更新前にバックアップを取る習慣と、ステージング環境での事前確認が、結局いちばん効果的な予防策です。
PR エックスサーバー
WordPressを、速く・止まらずに運営したい方へ
サーバー選びを間違えると、表示が遅い・サイトが止まるリスクがあります
こんなお悩みはありませんか?
- どのレンタルサーバーを選べばよいか分からない
- 表示が遅い・サイトが落ちるのが心配
- WordPressの設定やセキュリティに自信がない
サーバーは、あとから乗り換えると、データの移行やドメインの設定に手間がかかります。表示が遅い、突然止まるといったトラブルは、訪問者が離れる原因にもなります。最初に、稼働率の保証や実績を確認して選ぶのが安全です。
エックスサーバーなら、WordPressの運営に強いレンタルサーバーを、迷わず選べます。国内でWordPressを利用して運用されているサイトの集計(Dataprovider.com調べ、2025年6月)で、国内シェアNo.1と公式サイトに記載されています。
選ばれるポイント
- WordPressサイトの国内シェアNo.1。実績で選びたいときの安心材料(Dataprovider.com調べ、2025年6月)
- サイトが止まりにくい。月間稼働率99.99%以上を保証し、下回ると月額費用の一部を返金
- 攻撃に強い。WordPressを狙った攻撃の99%以上を未然に防ぐ機能(2024年9月15日〜11月15日の当社調べ)
- ドメイン代を節約できる。独自ドメインが永久無料(対象ドメイン・契約期間などの条件あり)
- テーマ選びも安心。人気テーマ「Cocoon」の開発・提供元が運営
- 10日間の無料お試しで、契約前に操作や表示の速さを確かめられる
10日間の無料お試しで、契約前に試せます
10日間無料でお試し
広告(アフィリエイト)を含みます。特長は2026年11月8日時点の公式サイトの記載で、数値・順位は各調査・調べの時点のものです。料金・条件は公式サイトでご確認ください。
WordPress 画面が真っ白になる原因とWP_DEBUGでの調べ方の関連項目
- 「サイトに重大なエラーが発生しました」が出たときの切り分け手順
- wp_get_environment_type() の使い方|説明・引数・注意点
- wp_die() の使い方|説明・引数・注意点
- is_wp_error() の使い方|説明・引数・注意点
- init フックの使い方|説明・引数・注意点
出典(一次情報)
本記事は情報提供を目的としています。WordPress本体やテーマ・プラグインのバージョンによって動作が異なる場合があるため、本番環境に反映する前に、必ずテスト環境で動作を確認してください。