WordPress AI接続で 500、502、503 が返る
WordPress、PHP、またはプラグインが処理中に内部エラーを発生させています。
秘密情報を含めず、正確なメッセージ、HTTPステータス、応答本文を記録します。
考えられる原因
- WordPress、PHP、またはプラグインが処理中に内部エラーを発生させています。
- プロキシまたはゲートウェイがWordPressオリジンから有効な応答を取得できません。
- DNS、TLS、接続、または上流処理がクライアントやプロキシのタイムアウトを超えています。
- デプロイ、更新、再起動、またはメンテナンスによりサービスが一時停止しています。
- オリジンのリソースが不足しているか、同時処理が現在の容量を超えています。
- 別のプラグインがHTTPS検出、RESTアクセス、またはApplication Passwordの可用性を変更しています。
診断手順
- 秘密情報を含めず、正確なメッセージ、HTTPステータス、応答本文を記録します。
- 変更前にWordPress、プラグイン、クライアント、コネクター、サーバーのバージョンを記録します。
- 一つのrequest IDに対応するWordPress、PHP、オリジン、ゲートウェイの秘密除去済みログを確認します。
- クライアント、プロキシ、オリジンのtimeoutと実測時間を比較します。
- RESTインデックスを取得し、期待するnamespaceと認証メタデータを確認します。
- ルート、メソッド、ルールIDを含むWAFまたはセキュリティイベントを確認します。
最小限の修正を適用する
- 秘密を除去したログに示されたWordPress、PHP、プラグイン、オリジンのエラーを修正します。
- 文書化されたメンテナンスまたは一時的な上流障害の終了後、同じテストを繰り返します。
- 同時実行数と再試行頻度を下げ、サーバーが示す待機時間を守ります。
- 保護全体を無効にせず、確認済みの誤検知ルール、パス、メソッドだけを調整します。
- プラグイン固有の動作が残る場合、秘密を除去したバージョン付き証拠でサポートへ連絡します。
結果を検証する
- 修正後、複数の小さな確認で安定した応答が返ります。
- RESTインデックスが正規HTTPS URLから応答し、期待するnamespaceを公開します。
- 承認された限定的な読み取りが再現可能な応答で成功します。
- 最終記録にバージョン、証拠、変更、検証、ロールバックが含まれ、秘密情報はありません。
避けるべき対応
- 接続テストを通す目的だけで管理者権限を付与しないでください。
- 一つのリクエストを通すためにWAFやセキュリティプラグイン全体を無効にしないでください。
- デバッグログや診断エンドポイントを公開しないでください。
- ライフサイクルを理解せず、認証情報の再生成や同じ失敗リクエストを繰り返さないでください。
- Application Password、Authorizationヘッダー、トークン、Cookieをプロンプト、チケット、ログ、画像に含めないでください。
関連ガイド
- WordPress AI接続で429 Too Many Requestsが返る
- セキュリティプラグインまたはWAFがWordPress REST APIをブロックする
- WordPressの/wp-json/が404を返す場合のREST API診断
- Claude Code または Codex の WordPress アクセスをトラブルシューティングする
- AIアシスタントでWordPress REST APIを使う
情報源と検証
このページは、以下の一次情報源に基づいて確認されています。 情報源の最終確認日: .
- RFC 9110: HTTP Semantics · RFC Editor
- REST API Handbook · WordPress Developer Resources
- Routes and Endpoints · WordPress Developer Resources