プラグイン更新後に発生する WordPress 500 エラー

このエラーの意味と見分け方

• プラグインを更新する前はサイトが正常に動作していたのに、その後、フロントエンド、WordPress ダッシュボード、またはその両方で HTTP 500 エラーが返される。
• 手動または自動のプラグイン更新後に障害が発生することがある。
• 公開サイトは表示される一方で /wp-admin/ だけが失敗する場合や、更新されたプラグインを使用するページとリクエストだけが失敗する場合がある。
• ブラウザーには、根本原因ではなく一般的な「500 Internal Server Error」、空白ページ、または WordPress の重大なエラーメッセージが表示されることがある。
• 最近更新したプラグインのディレクトリ名を変更すると、サイトが再び表示されることがある。
• サーバーまたは WordPress のデバッグログに、PHP の致命的エラー、構文エラー、ファイル欠落エラー、または更新されたプラグイン名を含むメッセージが記録されることがある。

可能性の高い順の主な原因

1. PHP の非互換性: 新しいプラグインバージョンが、サーバーで提供されていない PHP の機能またはバージョンを必要としている可能性があります。
2. プラグイン、テーマ、または WordPress の競合: 更新によって、別の拡張機能、現在のテーマ、またはインストールされている WordPress コアのバージョンとの相性が悪くなることがあります。関数やクラスの重複宣言は、よくある手がかりです。
3. 不完全または破損した更新: タイムアウト、接続の中断、ファイル転送の失敗によって、プラグインのファイルが欠落または破損することがあります。
4. プラグインのリグレッション: PHP と WordPress の要件を満たしていても、新しいリリースにサイトの構成へ影響する不具合が含まれている可能性があります。
5. 別の、またはより広範なホスティングの問題: 更新されたプラグインを無効にしても変化がない場合、500レスポンスは別の最近の変更、PHP設定、権限、リソース制限、またはサーバーレベルの障害に関係している可能性があります。

修正方法

1. 発生時期と影響範囲を確認する

エラーが発生する直前に更新されたプラグインを特定します。複数のプラグインを同時に更新した場合は、すべて記録してください。公開サイト、/wp-admin/、および失敗しているプラグイン固有の機能を確認します。疑わしい原因をテストするまでは、関係のない更新を避けてください。

2. ダッシュボードを使わずに更新されたプラグインを無効化する

ファイルを変更する前に、SFTP またはホスティングのファイルマネージャーからサイトへアクセスする権限があること、可能であれば最新のバックアップがあることを確認します。wp-content/plugins/ を開き、疑わしいプラグインのディレクトリ名に -disabled などの接尾辞を追加して変更します。

フロントエンドと /wp-admin/ を再読み込みします。

• サイトが復旧した場合は、ログを確認してロールバックまたは互換性の修正方法を選ぶ間、プラグインを無効のままにします。
• 変化がない場合は、元のディレクトリ名に戻し、同時に更新された次のプラグインをテストします。
• 最近更新されたすべてのプラグインを無効にしてもエラーが残る場合は、サーバーと PHP のログを確認し、最近行われた他のホスティング設定や構成変更を見直します。

ディレクトリ名を変更すると、WordPress が読み込むプラグインが変わります。そのため、根本的な問題の特定と修正の代わりとして使用しないでください。

3. 根本原因である PHP エラーを記録する

500レスポンスは表面上の症状にすぎません。wp-config.php を編集する権限がある場合は、編集終了を示す行より上で、一時的にログ記録を有効にします。

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

疑わしいプラグインを無効にしたまま、必要に応じて現在のログを保存します。障害を再現できる状態になったらプラグインを再有効化し、1回だけ再現させて、wp-content/debug.log とホスティングパネルの PHP またはサーバーのエラーログを確認します。プラグイン名、PHPバージョンに関するメッセージ、ファイル欠落、構文エラー、Cannot redeclare function、Cannot declare class を探してください。

デバッグログには、実装に関する機密情報が記録される可能性があるため、一時的に使用してください。テスト後は設定を無効にします。特に公開中の本番サイトでは、ホスティングの手順に従って、露出したログデータを削除または保護してください。

4. ログのメッセージを推定される原因と照合する

• サポートされていない PHP 機能または必要な PHP バージョンに関するメッセージは、PHP の互換性の問題を示します。
• Cannot redeclare function または Cannot declare class とともに2つの拡張機能やテーマの名前が示されている場合は、互換性の競合が疑われます。
• 最近更新されたプラグインのディレクトリ内で、ファイル欠落、構文エラー、またはエラーが示されている場合は、不完全または破損した更新が考えられます。
• WordPress コアまたは別の拡張機能の名前が示されている場合は、更新によってより広範な互換性の問題が表面化した可能性があります。
• ログにプラグイン名も関連コンポーネント名もない場合は、更新が原因だと決めつける前に、ホスティングレベルのエラーを確認してください。

5. 最後に正常動作していたプラグインバージョンへロールバックする

サイトをすぐに復旧する必要がある場合は、現在のプラグインファイルのコピーを保存し、検証済みのバックアップまたはプラグインの確立された配布元から入手した古いパッケージを使用します。SFTP またはホスティングのファイルマネージャーからアップロードまたは復元し、プラグインを再有効化する前にサイトをテストします。

動作するバックアップの唯一のコピーを上書きしないでください。原因が把握でき、互換性のあるリリースが利用可能になるまで、このプラグインの自動更新を無効にするか、更新を確認制にしてください。

6. PHP と WordPress の要件を確認する

更新されたプラグインリリースが示す PHP と WordPress の最低バージョンを、サイトの実際のバージョンと比較します。ダッシュボードを利用できる場合、PHP情報は通常 ツール → サイトヘルス → 情報 に表示されます。ホスティングのコントロールパネルに現在の PHP バージョンが表示される場合もあります。

PHP または WordPress がプラグインの要件を下回っている場合は、バックアップを作成し、アップグレード前にテーマ、他のプラグイン、ホスティング環境との互換性を確認します。PHP をホストが管理している場合は、サポートされているアップグレード方法をホストに確認してください。変更によってサイト全体に影響する可能性があるため、本番環境の PHP バージョンを無計画に変更しないでください。

7. 確認された競合またはリグレッションをエスカレーションする

互換性のない更新を無効のままにするか、最後に正常動作していたバージョンへ戻したうえで、正確な致命的エラー、プラグインのバージョン、PHP バージョン、WordPress バージョン、再現手順を関連するプラグインまたはテーマの開発者に報告します。プラグインファイルを恒久的に編集することは避けてください。今後の更新で変更が上書きされ、サイトがサポート対象外になる可能性があります。

予防と修正確認

• プラグインを更新する前に、データベースとサイトファイルの両方をバックアップし、復元できることを確認します。
• 可能な場合はプラグインを個別に更新し、障害を特定の変更と結び付けられるようにします。
• 重要なプラグイン、WordPress、PHP の変更は、本番環境に適用する前にステージング環境でテストします。
• PHP と WordPress を、プラグインとテーマが示すサポート対象の範囲内に保ちます。
• 更新するたびに、公開サイト、/wp-admin/、ログイン、フォーム、更新されたプラグインが提供する機能をテストします。
• ビジネスに不可欠なプラグインや、互換性の問題を過去に起こしたプラグインについては、自動更新を確認制にします。
• 最後に正常動作していたプラグインのバージョンと復旧方法を記録し、すぐ使える状態にしておきます。
• トラブルシューティング後は、一時的なデバッグ表示とログ記録の設定を無効にし、内部エラーの詳細を含むログを保護または削除します。

よくある質問