WordPressが真っ白・500エラー・「重大なエラーが発生しました」の切り分け(PHPエラー・プラグイン・テーマ・メモリ・PHP版・.htaccess・権限・ログ)
要点
まず直前の変更とエラーログを見る。原因の多くはプラグイン・テーマの更新、PHP版変更、メモリ不足、.htaccess。1つずつ切り分け(プラグイン→テーマ→.htaccess→メモリ→PHP版→権限)、大量変更はしない。
最初に
- 直前に何を変えたか(更新・プラグイン追加・PHP版・
.htaccess・コード編集)→ まずそれを疑う(障害時は直前の変更を疑う・変更履歴を残す(更新・CSS・DNS・サーバー設定・PHP・SSL・外部サービス))。 - 全ページか一部か、管理画面も落ちているか、他のサイト(同じサーバー)も落ちているか(障害対応の基本(いきなり直さず症状を切り分ける14の確認順))。
- エラーログを見る(サーバー管理画面のエラーログ)。
PHP Fatal error: ... in /wp-content/plugins/<名前>/...のように原因のファイルが書いてあることが多い。 - 「このサイトで重大なエラーが発生しました」の場合、管理者メールにリカバリーモードのリンクと原因のプラグイン/テーマが届いていることがある。
原因候補と切り分け(1つずつ)
| 候補 | 確認・切り分け | 戻し方 |
|---|---|---|
| プラグイン | ログに出たプラグイン、直前に更新したもの。SFTPで wp-content/plugins/<名前> のフォルダ名を一時的に変えると停止扱いになる | 原因のプラグインだけ停止、前の版に戻す |
| テーマ | ログにテーマのファイル。functions.php の編集直後 | 編集を元に戻す。既定テーマに一時切替(本番では最終手段) |
| メモリ不足 | ログに Allowed memory size ... exhausted | wp-config.php の WP_MEMORY_LIMIT やサーバーのPHP設定(上限はサーバー次第) |
| PHPバージョン | PHPを変えた直後、古いプラグイン | 元のPHP版に戻して、対応版に更新してから再挑戦 |
.htaccess | 編集直後、リダイレクト追加直後に全ページ500 | 控えた元のファイルに戻す(名前を変えて一時退避→パーマリンク設定の保存で再生成) |
| ファイル権限 | 移転・アップロード直後、403や500 | フォルダ755・ファイル644(サーバーの基本(種類・何がどこにあるか・public_html・PHP・DB・FTP/SFTP/SSH・権限・ログ)) |
| 更新の途中失敗 | 「メンテナンスのため一時的に利用できません」のまま | ドキュメントルートの .maintenance を確認 |
| サーバー側 | 同じサーバーの他サイトも落ちている | サーバー会社の障害情報 |
エラーを表示して調べる
wp-config.php で一時的に:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true ); // wp-content/debug.log に記録
define( 'WP_DEBUG_DISPLAY', false ); // 画面には出さない
調べ終わったら必ず元に戻し、debug.log を削除する(誰でも読める場所にあるとサーバー情報が漏れる)。
WP-CLIは --skip-plugins --skip-themes を付けると、壊れたプラグインを読み込まずに状態確認できる(WP-CLIの確認コマンドと変更コマンドの区別(option・post・plugin・theme・eval-file・search-replace))。
注意
- いきなり全プラグイン停止・テーマ変更・PHP変更を同時にしない。直ったときに原因が分からず、別の不具合(設定消失・デザイン崩れ)を起こす。
- 触る前に、変更するファイルの控え・バックアップ(WordPressのバックアップ対象と種類の使い分け(DB・wp-content・フル/DBのみ/差分・世代管理)と「戻せるか」の確認)。
- 直ったら、原因と対処を変更履歴に残す。