„502 Bad Gateway“ – ResponseWithBody

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation. Weitere Informationen

Symptom

Die Clientanwendung ruft den HTTP-Statuscode 502 Bad Gateway mit dem Fehler ab Code protocol.http.ResponseWithBody als Antwort für API-Aufrufe.

Fehlermeldung

Die Clientanwendung ruft den folgenden Antwortcode ab:

HTTP/1.1 502 Bad Gateway

Außerdem sehen Sie möglicherweise eine der folgenden Fehlermeldungen:

{
   "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"
      }
   }
}

Mögliche Ursachen

Dieser Fehler tritt auf, wenn die HTTP-Antwort vom Backend-Server an Apigee Edge entweder 204 No Content oder 205 Reset Content, enthält aber die response body und/oder mindestens einen der folgenden Header:

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

Gemäß den Spezifikationen <ph type="x-smartling-placeholder"></ph> RFC 7231, Abschnitt 6.3.5: 204 No Content und <ph type="x-smartling-placeholder"></ph> RFC 7231, Abschnitt 6.3.6: 205 Reset Content, wird erwartet, dass keine zusätzlichen Inhalte sollte vom Ursprungsserver als Teil des Antwortnutzlasttexts mit dem Statuscode 204 No Content oder 205 Reset Content gesendet werden. Die Antwortheader wie Content-Length, Content-Encoding oder Transfer-Encoding geben die Größe, den Typ oder das Format der Antwortnutzlast an.

Daher gibt Apigee Edge einen 502 Bad Gateway-Statuscode mit dem Client den Fehlercode protocol.http.ResponseWithBody unter Gegebenheiten:

	Statuscode vom Backend-Server
Antwort vom Backend-Server enthält	204 Kein Inhalt	205 Inhalte zurücksetzen
Antworttext	FEHLER	FEHLER
Content-Length-Header (auf ungleich null gesetzt)	FEHLER	FEHLER
Content-Encoding (Festlegen auf <ph type="x-smartling-placeholder"></ph> unterstützte Codierung in Apigee Edge)	FEHLER	KEIN FEHLER
Transfer-Encoding	FEHLER	FEHLER
<ph type="x-smartling-placeholder">

Mögliche Ursachen für diesen Fehler:

Ursache	Beschreibung	Anleitungen zur Fehlerbehebung gelten für
Antworttext oder Header mit 204-Antwort vom Backend-Server	Der Backend-Server sendet eine 204 No Content oder 205 Reset Content Antwort mit einem Antworttext und/oder einem oder mehreren der Header Content-Type, Content-Encoding oder Transfer-Encoding.	Edge-Nutzer von öffentlichen und privaten Clouds

Allgemeine Diagnoseschritte

Verwenden Sie eines der folgenden Tools oder Techniken, um diesen Fehler zu diagnostizieren:

Ursache: Antworttext oder Header mit 204-Antwort vom Backend-Server

Diagnose

1. Ermitteln Sie den Fehlercode und die Fehlerquelle für den mit der API beobachteten Fehler. Monitoring-, Trace-Tool- oder NGINX-Zugriffslogs wie unter Häufige Diagnoseschritte.
2. Wenn der Fehlercode protocol.http.ResponseWithBody ist und Fehlerquelle den Wert target hat, bedeutet dies, dass das Back-End Der Server hat mit dem Status 204 No Content oder 205 Reset Content geantwortet. mit dem Antworttext und/oder einem der Header in Mögliche Ursachen:

3. Um zu überprüfen, ob der Back-End-Server tatsächlich einen Antwortnutzlasttext und/oder einen Antwortnutzlasttext gesendet hat. oder mehreren der unter Mögliche Ursachen genannten Überschriften, können Sie führen Sie die folgenden Schritte aus:

   1. Wenn Sie Nutzer einer öffentlichen Cloud sind und dieselbe API-Anfrage an den Back-End-Server direkt von einem Ihrer Systeme.

      <ph type="x-smartling-placeholder">
   2. Wenn Sie ein Private Cloud-Nutzer sind, können Sie dieselbe API-Anfrage an den Back-End-Server direkt von einem der Message Processor aus, die dem spezifischen Organisation und Umgebung, in der der Fehler beobachtet wird.

   3. Prüfen Sie die vom Back-End-Server erhaltene Antwort und vergewissern Sie sich, dass sie einen Nutzlasttext der Antwort und/oder mindestens einen der oben genannten Header. Wenn ja, ist das die Ursache des Fehlers.

      Beispiel 1

      Beispiel 1: Antwort 204 des Backend-Servers mit Content-Encoding-Header

      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
      

      In diesem Beispiel hat der Back-End-Server mit 204 No Content-Statuscode und Content-Encoding: gzip

      Beispiel 2

      Beispiel 2: Antwort 204 des Backend-Servers mit Content-Length-Header

      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
      

      In diesem Beispiel hat der Back-End-Server mit 204 No Content-Statuscode und Content-Length: 48

      Beispiel 3

      Beispiel 3: Antwort 205 des Back-End-Servers mit Antworttext

      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
      

      In diesem Beispiel hat der Back-End-Server mit 205 Reset Content-Statuscode mit Antworttext This is a sample Response.

   4. In allen obigen Beispielen hat der Back-End-Server 204 No Content oder Statuscode 205 Reset Content mit dem Antworttext und/oder einem der Header die unter Mögliche Ursachen aufgeführt sind.
   5. Daher hat Apigee Edge den Statuscode 502 Bad Gateway mit Fehlercode gesendet protocol.http.ResponseWithBody.

Auflösung

Sicherstellen, dass der Backend-Server immer die Spezifikation einhält <ph type="x-smartling-placeholder"></ph> RFC 7231, Abschnitt 6.3.6: 205 Reset Content beim Senden der 204 No Content oder 205 Reset Content-Antwort auf Apigee Edge. Das heißt, der Back-End-Server Folgendes DARF NICHT als Teil eines 204 No Content- oder Antwort von 205 Reset Content:

1. Antwortnutzlasttext
2. und einer der folgenden Überschriften: <ph type="x-smartling-placeholder">
   </ph>
   1. Content-Length
   2. Content-Encoding
   3. Transfer-Encoding

Spezifikation

Apigee Edge antwortet mit dem Statuscode 502 Bad Gateway und dem Fehlercode protocol.http.ResponseWithBody, wenn der Backend-Server eine Antwort „204 No Content“ oder „205 Reset Content“, aber nicht den folgenden RFC-Spezifikationen entspricht:

Spezifikation
<ph type="x-smartling-placeholder"></ph> RFC 7231, Abschnitt 6.3.5: 204 No Content
<ph type="x-smartling-placeholder"></ph> RFC 7231, Abschnitt 6.3.6: 205 Content zurücksetzen

Wichtige Punkte

Die empfohlene Lösung besteht darin, den Backend-Server so zu reparieren, dass er 204 No Content sendet und den Statuscode 205 Reset Content ohne Antworttext und Header: Content-Length, Content-Encoding und Transfer-Encoding und den Spezifikationen entsprechen . RFC 7231, Abschnitt 6.3.5: 204 No Content und RFC 7231, Abschnitt 6.3.6: 205 Reset Content.

Wenn Sie weitere Unterstützung vom Apigee-Support benötigen, gehen Sie zu Diagnoseinformationen müssen erfasst werden.

Erfassen von Diagnoseinformationen erforderlich

Erfassen Sie die folgenden Diagnoseinformationen und wenden Sie sich an den Apigee Edge-Support:

Wenn Sie ein Public Cloud-Nutzer sind, geben Sie die folgenden Informationen an:

• Name der Organisation
• Name der Umgebung
• API-Proxy-Name
• Vollständiger curl-Befehl zum Reproduzieren des 502-Fehlers
• Ablaufverfolgungsdatei für API-Anfragen

Wenn Sie ein Private Cloud-Nutzer sind, geben Sie die folgenden Informationen an:

• Vollständige Fehlermeldung für fehlgeschlagene Anfragen
• Name der Umgebung
• API-Proxy-Bundle
• Ablaufverfolgungsdatei für API-Anfragen

• NGINX-Zugriffslogs /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Wo:ORG, ENV und PORT# werden ersetzt durch tatsächliche Werte.

• Systemprotokolle des Message Processor /opt/apigee/var/log/edge-message-processor/logs/system.log