エラー502の解読：NginxとPHP-FPMにおけるプロキシ層の障害の徹底分析

I. はじめに

よくある誤解がある。502 不正なゲートウェイエラーは「サーバーがダウンしている」ことを意味する。これは、効果的なトラブルシューティングを導くにはあまりにも一般的な理解です。より正確な例えは、サイト・アーキテクチャ全体を共同作業チームと考えることです。

このチームではプロキシサーバー（例Nginxもしかしたらアパッチ通訳」の役割。来訪者（ユーザーリクエスト）の受信を担当します。入ってくる訪問者（ユーザーリクエスト）を受け取り、最初のコミュニケーションを行い、専門的な質問をバックエンドの "エキスパート "に伝えます。

バックエンドプロセスPHP-FPMそれはこの "専門家 "だった。.ビジネスロジックに精通しており、PHPコードを実行し、データベースと通信し、最終的なウェブコンテンツを生成することができる。

502エラーの本質は、この連携の連鎖が途切れていることです。つまり、「翻訳者」(Nginx)が上流の「専門家」(PHP-FPM)に問題を問い合わせた後、予定された時間内に有効な回答を受け取れなかったり、単に理解できない回答を受け取ったりすることを意味します。トランスレータは訪問者に "502 Bad Gateway" 通知を表示し、通信に失敗したことを宣言することしかできません。

II. プロフェッショナル・セグメンテーション：エージェントとバックエンド間の "ハンドシェイク "失敗の3つの根本原因

失敗はすべて502に見えるが、その背後にある根本原因はさまざまである。これらの根本原因をより深く理解することが、問題の根源に迫る第一歩である。

1.リクエストタイムアウト：忍耐の限界

プロキシサーバーは無限に待つわけではない。バックエンドの応答を待つ期限を設定するタイマーが組み込まれている。

主要パラメータ分析
- Nginx。 プロキシ・リード・タイムアウト このディレクティブは Nginx がバックエンドにリクエストした後、バックエンドからの応答を待つ最大時間を定義します。デフォルト値は通常 60 秒です。
- PHP-FPM。 リクエスト終了タイムアウト このディレクティブは、PHP スクリプトの実行時間の上限を設定します。これは、実行時間が長すぎるスクリプトを終了させるセーフティネットの役割を果たします。
現実的なトリガーシナリオ
複合体WooCommerce商品クエリ、または動作の遅いページビルダープラグインは、非常に時間のかかるPHPコードを実行する可能性があります。このコードの実行にプロキシ・リード・タイムアウトもしかしたらリクエスト終了タイムアウトを設定すると、Nginx は積極的にコネクションを閉じ、ユーザに 502 エラーを返します。この時点で、バックエンドプロセスはまだ頑張っているかもしれませんが、通信ブリッジはプロキシによって一方的に遮断されています。

2.資源の枯渇：兵士不在のジレンマ

PHP-FPM は通常、作業単位をプロセスのプールとして管理する。これは、人数の決まった専門家チームのようなものである。

コアメカニズムの解剖学
- pm.max_children この PHP-FPM 設定パラメータは、子プロセスの最大作成数を決定します。同時に発生するユーザからのリクエストは、それぞれ別の子プロセスで処理する必要があります。

断層形成過程
サイトのトラフィックが急増した場合や、何らかの理由でリクエストが長時間ハングした場合（例えば、外部からのエーピーアイ新しいリクエストが到着すると、PHP-FPM のサブプロセスは占有されます。この時点で、新しいリクエストが到着すると、すべての "エキスパート" がビジー状態になります。リクエストはキューで待たされ、待ち時間が長すぎたりキューが一杯になったりすると、プロキシサーバー (Nginx) はリソースを割り当てることができず、最終的に 502 エラーを返します。これはサーバのハードウェアリソース（CPU/メモリ）の完全な枯渇ではなく、リソースプールのアプリケーション固有の枯渇です。

3.プロセス崩壊：予期せぬ突然死

バックエンドプロセスは不滅ではないので、重大な内部エラーによって突然終了する可能性がある。

崩壊の原因を探る
- メモリオーバーフローメモリリークのあるプラグインやテーマは、PHPプロセスがPHPのメモリ制限(メモリリミット)、システムによって強制終了された。
- セグメンテーションいはんPHPの拡張機能の中には、特定のバージョンと互換性がなかったり、サーバー環境と衝突したりするものがあります。セグメンテーションいはん(セグメンテーション・フォールト）が発生し、プロセスが即座にクラッシュする。
- 致命的エラー: 珍しいことではありますが、ある種の深刻なPHPの致命的エラーがプロセスの終了を引き起こすこともあります。
コミュニケーションの結果
リクエストの処理中にPHP-FPMプロセスがクラッシュすると、PHP-FPMとNginxの間に確立されたTCPコネクションが切断され、Nginxはこの切断されたコネクションから有効なHTTPレスポンスを取得できなくなり、その結果ログにSSLハンドシェイクで接続が切断されたなどのエラーが発生し、ユーザーに502のステータスコードを返す。

III.結論：症状と病気の根本原因との弁証法的関係

502バッド・ゲートウェイ・エラーを系統的に解決するには、新しい理解が必要である。502は明確な「症状」であるが、バックエンド・サービス（PHP-FPM）の健全性とプロキシ・レイヤー（Nginx）が期待するコンフィギュレーションとのミスマッチを指している。

やみくもにサービスを再起動したりタイムアウトを増やしたりしても、一時的に問題が隠蔽されるだけです。つまり、タイムアウト設定の妥当性をチェックし、 PHP-FPMプロセスプールの使用状況を監視し、PHPのエラーログを分析してプロセスクラッシュの根本原因を突き止めるのです。ハンドシェイク」失敗の真の原因を突き止めることによってのみ、最も効果的な修正を実施し、ゲートウェイを再びスムーズなブリッジにすることができる。

お問い合わせ
チュートリアルが読めない？無料でお答えします！個人サイト、中小企業サイトのための無料ヘルプ！	カスタマーサービス WeChat
① 電話：020-2206-9892
② QQ咨询：1025174874
三 Eメール：[email protected]
④ 勤務時間: 月～金、9:30～18:30、祝日休み