プラグイン競合を切り分ける手順

プラグインを追加・更新した後に表示や管理画面が壊れた場合、すべてを無効化するだけでは原因を説明できません。変更を戻せる環境を用意し、条件を一つずつ固定して切り分けます。

1. 変更点と症状を記録する

発生時刻、対象URL、操作、期待した結果、実際の結果を記録します。直前に行ったプラグイン更新、WordPress更新、PHP変更、テーマ変更も一覧にします。

2. ログを確保する

ブラウザの開発者ツール、PHPエラーログ、WordPressのデバッグログ、サーバーやCDNのログを確認します。画面のエラーメッセージだけで原因を決めないことが重要です。

3. キャッシュを分けて考える

ブラウザ、WordPress、サーバー、CDNには別々のキャッシュがあります。どれを削除したかを記録し、キャッシュ削除で直ったのか、時間経過で直ったのかを区別します。

4. ステージングで最小構成を作る

本番の複製を用意し、対象プラグイン以外を止め、WordPress標準テーマへ切り替えます。症状が消えたら、テーマと他プラグインを一つずつ戻します。

5. 組み合わせを特定する

対象プラグイン単体で動く場合は、別のプラグインまたはテーマとの組み合わせが原因です。機能が近いもの、同じJavaScriptを読み込むもの、キャッシュやセキュリティへ介入するものから確認します。

6. 一時対応と恒久対応を分ける

バージョンを戻す、機能を止める、キャッシュを外す対応は復旧策です。恒久対応では、原因となる条件、影響範囲、再発確認の方法を残します。

本番で避けること

• バックアップなしで更新と削除を繰り返す
• 複数の設定を同時に変える
• 原因が不明なままログ出力を無効にする
• 古いバージョンへ戻したまま放置する

競合調査の目的は「動く組み合わせ」を偶然見つけることではなく、どの条件で壊れるかを説明できる状態にすることです。