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・メモリ確認の順で進めるのが効率的です。エラーログにファイル名と行番号が出れば、そこが原因箇所です。
関連記事: