2026年5月20日

2026年5月20日

WordPressの白い画面をデバッグする方法:原因を特定する手順

はじめに

WordPressが真っ白になる「白い画面(WSOD)」は、原因が1つとは限りません。プラグイン・テーマ・PHPコード・サーバー設定など様々な要素が絡み合います。この記事では、原因を素早く特定するための体系的なデバッグ手順を解説します。

デバッグの基本戦略:二分探索

WSODのデバッグは「二分探索」が効果的です。候補を半分ずつ絞り込むことで、数十個のプラグインがあっても5〜6ステップで原因を特定できます。

ステップ1:WP_DEBUGでエラーを可視化する

まずエラーメッセージを表示させます。FTPで wp-config.php を開き、以下を設定します:

// wp-config.php に追加・変更
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false ); // 本番環境ではfalseに
define( 'SCRIPT_DEBUG', true );

設定後、wp-content/debug.log にエラーが記録されます。エラーメッセージにファイル名と行番号が含まれるので、原因箇所が特定できます。

ステップ2:プラグインの二分探索

エラーログから原因が分からない場合、プラグインを段階的に無効化します:

全プラグインを一括無効化

FTPで wp-content/plugins/ フォルダの名前を変更します:

plugins/ → plugins_disabled/

サイトが復旧したらプラグインが原因。戻したあと個別に特定します。

個別プラグインの特定(二分探索)

全10個のプラグイン
→ 5個を無効化 → まだエラー → 残り5個の中に原因
→ その2〜3個を無効化 → 復旧 → 無効化した中に原因
→ 1個ずつ試す → 特定完了

ステップ3:テーマの切り替え

プラグインが原因でなければテーマを確認します。FTPで wp-content/themes/ 内のアクティブテーマフォルダ名を変更します。WordPressはデフォルトテーマ(Twenty Twenty-Four等)に自動的に切り替わります。

themes/my-theme/ → themes/my-theme_disabled/

ステップ4:PHPバージョンの確認

ホスティングのコントロールパネル(cPanel等)でPHPバージョンを確認します。最近バージョンが変わった場合は、元のバージョンに戻してみてください。

ステップ5:メモリ制限の増加

// wp-config.php
define( 'WP_MEMORY_LIMIT', '256M' );
define( 'WP_MAX_MEMORY_LIMIT', '512M' );

ステップ6:wp-config.phpでのデータベース接続確認

define( 'DB_NAME', 'データベース名' );
define( 'DB_USER', 'ユーザー名' );
define( 'DB_PASSWORD', 'パスワード' );
define( 'DB_HOST', 'localhost' );

ホスティング管理画面で正しい値を確認し、一致しているか照合します。

注意事項

  • デバッグ設定(WP_DEBUG_DISPLAY)は本番環境では必ず false にしてください。エラーが公開されるとセキュリティリスクになります。
  • 変更前には必ず wp-config.php のバックアップを作成してください。

まとめ

WSODのデバッグは①エラーログ確認→②プラグイン二分探索→③テーマ切替→④PHP・メモリ確認の順で進めるのが効率的です。エラーログにファイル名と行番号が出れば、そこが原因箇所です。

関連記事:

お気軽にご相談ください

お見積りへ お問い合わせへ