WordPressが真っ白・500エラー・「重大なエラーが発生しました」の切り分け(PHPエラー・プラグイン・テーマ・メモリ・PHP版・.htaccess・権限・ログ)

要点

まず直前の変更とエラーログを見る。原因の多くはプラグイン・テーマの更新、PHP版変更、メモリ不足、.htaccess。1つずつ切り分け(プラグイン→テーマ→.htaccess→メモリ→PHP版→権限)、大量変更はしない。

最初に

  1. 直前に何を変えたか(更新・プラグイン追加・PHP版・.htaccess・コード編集)→ まずそれを疑う(障害時は直前の変更を疑う・変更履歴を残す(更新・CSS・DNS・サーバー設定・PHP・SSL・外部サービス))。
  2. 全ページか一部か、管理画面も落ちているか、他のサイト(同じサーバー)も落ちているか(障害対応の基本(いきなり直さず症状を切り分ける14の確認順))。
  3. エラーログを見る(サーバー管理画面のエラーログ)。PHP Fatal error: ... in /wp-content/plugins/<名前>/... のように原因のファイルが書いてあることが多い。
  4. 「このサイトで重大なエラーが発生しました」の場合、管理者メールにリカバリーモードのリンクと原因のプラグイン/テーマが届いていることがある。

原因候補と切り分け(1つずつ)

候補確認・切り分け戻し方
プラグインログに出たプラグイン、直前に更新したもの。SFTPで wp-content/plugins/<名前> のフォルダ名を一時的に変えると停止扱いになる原因のプラグインだけ停止、前の版に戻す
テーマログにテーマのファイル。functions.php の編集直後編集を元に戻す。既定テーマに一時切替(本番では最終手段)
メモリ不足ログに Allowed memory size ... exhaustedwp-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))。

注意