502 Bad Gateway - ResponseWithBody

<ph type="x-smartling-placeholder"></ph> 現在、Apigee Edge のドキュメントが表示されています。
Apigee X のドキュメント。 詳細

症状

クライアント アプリケーションが HTTP ステータス コード 502 Bad Gateway とエラーを取得する API 呼び出しのレスポンスとしてコード protocol.http.ResponseWithBody を渡します。

エラー メッセージ

クライアント アプリケーションが次のレスポンス コードを受け取ります。

HTTP/1.1 502 Bad Gateway

また、次のいずれかのエラー メッセージが表示される場合があります。

{
   "fault":{
      "faultstring":"Received 204 Response with message body",
      "detail":{
         "errorcode":"protocol.http.ResponseWithBody"
      }
   }
}

{
   "fault":{
      "faultstring":"Received 205 Response with message body",
      "detail":{
         "errorcode":"protocol.http.ResponseWithBody"
      }
   }
}

考えられる原因

このエラーは、バックエンド サーバーから Apigee Edge への HTTP レスポンスが次のいずれかの場合に発生します。 204 No Content または 205 Reset Content（ただし response を含む） body および/または次のヘッダー（1 つまたは複数）を使用できます。

• Content-Length
• Content-Encoding
• Transfer-Encoding

仕様に基づく <ph type="x-smartling-placeholder"></ph> RFC 7231、セクション 6.3.5: 204 No Content、 <ph type="x-smartling-placeholder"></ph> RFC 7231、セクション 6.3.6: 205 Reset Content と同様に、追加のコンテンツがないことが想定されます。 配信元サーバーからステータス コード 204 No Content または 205 Reset Content のレスポンス ペイロード本文の一部として送信する必要があります。レスポンス ヘッダー Content-Length、Content-Encoding、 Transfer-Encoding は、レスポンス ペイロードのサイズ、型、形式を示します。

このため、Apigee Edge は次のようなステータス コード 502 Bad Gateway を返します。 クライアントにエラーコード protocol.http.ResponseWithBody を 状況:

このエラーには、次の原因が考えられます。

共通の診断手順

このエラーを診断するには、次のいずれかのツールまたは手法を使用します。

原因: バックエンド サーバーからのレスポンスの本文またはヘッダーに 204 レスポンスが含まれている

診断

1. API を使用して、観測されたエラーの障害コードと障害ソースを特定します。 Monitoring、Trace ツール、または NGINX アクセスログを 一般的な診断手順。
2. 障害コードが protocol.http.ResponseWithBody で、 [Fault Source] の値が target の場合、これはバックエンドが サーバーが 204 No Content ステータスまたは 205 Reset Content ステータスを返した レスポンスの本文および/または 考えられる原因。

3. バックエンド サーバーがレスポンス ペイロードの本文や 1 つを実際に送信したかどうかを検証する 考えられる原因に記載されたヘッダーに該当しない場合、 次の操作を行います。

   1. Public Cloud ユーザーで、プロジェクトに対して同じ API リクエストを行える場合は、 任意のシステムからバックエンド サーバーを

      <ph type="x-smartling-placeholder">
   2. Private Cloud ユーザーは、同じ API リクエストを 特定の 1 に関連付けられた Message Processor の 1 つからバックエンド サーバーからの直接接続を 組織と環境を定義します。

   3. バックエンド サーバーから受信したレスポンスを確認し、 レスポンス ペイロードの本文や上記のヘッダーの 1 つ以上を含めることができます。「はい」の場合 確認できます。

      サンプル 1

      サンプル 1: Content-Encoding ヘッダーを含むバックエンド サーバーのレスポンス 204

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 204 No Content
      < Content-Encoding: gzip
      < Date: Tue, 31 Jul 2021 21:41:13 GMT
      < Connection: keep-alive
      

      このサンプルでは、バックエンド サーバーからのレスポンス 204 No Content ステータス コードと Content-Encoding: gzip

      サンプル 2

      サンプル 2: Content-Length ヘッダー付きのバックエンド サーバーのレスポンス 204

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 204 No Content
      < Content-Length: 48
      < Date: Tue, 31 Jul 2021 21:41:13 GMT
      < Connection: keep-alive
      

      このサンプルでは、バックエンド サーバーからのレスポンス 204 No Content ステータス コードと Content-Length: 48

      サンプル 3

      サンプル 3: バックエンド サーバーのレスポンス 205 とレスポンス本文

      curl -v "https://BACKEND_SERVER_HOST_NAME/PATH" -H "HEADER: VALUE" -X HTTP_REQUEST_METHOD
      

      …
      < HTTP/1.1 205 Reset Content
      < Date: Sat, 31 Jul 2021 17:14:09 GMT
      < Content-Length: 12
      < Content-Type: text/plain; charset=utf-8
      <
      * Connection #0 to host X.X.X.X left intact
      This is a sample Response
      

      このサンプルでは、バックエンド サーバーからのレスポンス レスポンス本文を含む 205 Reset Content ステータス コード This is a sample Response.

   4. 上のすべての例では、バックエンド サーバーは 204 No Content または レスポンスの本文またはヘッダーのいずれかを含む 205 Reset Content ステータス コード 考えられる原因に記載があります。
   5. そのため、Apigee Edge はエラーコード付きの 502 Bad Gateway ステータス コードを送信した protocol.http.ResponseWithBody。

解決策

バックエンド サーバーが常に仕様を遵守していることを確認する <ph type="x-smartling-placeholder"></ph> RFC 7231、セクション 6.3.6: 205 Reset Content（204 No Content を送信する場合） または 205 Reset Content レスポンスが返されます。つまり、バックエンド サーバーは 次の内容を送信してはいけません204 No Content または 205 Reset Content レスポンス:

1. レスポンス ペイロードの本文
2. 次のいずれかのヘッダー: <ph type="x-smartling-placeholder">
   </ph>
   1. Content-Length
   2. Content-Encoding
   3. Transfer-Encoding

仕様

Apigee Edge が 502 Bad Gateway ステータス コードとエラーコードを返す protocol.http.ResponseWithBody バックエンド サーバーがサーバーを 204 No Content または 205 Reset Content のレスポンス。ただし、 は次の RFC 仕様に準拠していません。

主な注意点

推奨される解決策は、204 No Content を送信するようにバックエンド サーバーを修正することです。 および 205 Reset Content ステータス コード（レスポンス本文および ヘッダー - Content-Length、Content-Encoding、 Transfer-Encoding であり、仕様を遵守する RFC 7231、セクション 6.3.5: 204 No Content、 RFC 7231、セクション 6.3.6: 205 Reset Content。

Apigee サポートのサポートが必要な場合は、 診断情報の収集が必要な場合。

診断情報の収集が必要な場合

次の診断情報を収集して、Apigee Edge サポートに連絡してください。

Public Cloud ユーザーの場合は、次の情報を提供します。

• 組織名
• 環境名
• API プロキシ名
• 502 エラーの再現に使用する完全な curl コマンド
• API リクエストのトレース ファイル

Private Cloud ユーザーの場合は、次の情報を提供します。

• 失敗したリクエストについて観測された完全なエラー メッセージ
• 環境名
• API プロキシ バンドル
• API リクエストのトレース ファイル

• NGINX アクセスログ /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  ここで、ORG、ENV、PORT# は、 使用します。

• Message Processor システムログ /opt/apigee/var/log/edge-message-processor/logs/system.log