400 Bad Request – DuplicateHeader

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen

Symptom

Die Clientanwendung erhält als Antwort auf API-Aufrufe den HTTP-Statuscode 400 Bad Request mit dem Fehlercode protocol.http.DuplicateHeader .

Fehlermeldung

Die Clientanwendung ruft den folgenden Antwortcode ab:

HTTP/1.1 400 Bad Request

Außerdem wird möglicherweise eine Fehlermeldung wie die folgende angezeigt:

{
   "fault":{
      "faultstring":"Duplicate Header \"Expires\"",
      "detail":{
         "errorcode":"protocol.http.DuplicateHeader"
      }
   }
}

Mögliche Ursachen

Dieser Fehler tritt auf, wenn ein bestimmter HTTP-Header, für den in Apigee Edge keine Duplikate zulässig sind, mehr als einmal mit denselben oder unterschiedlichen Werten als Teil der HTTP-Anfrage angezeigt werden, die vom Client an Apigee Edge gesendet wird.

Gemäß RFC 7230, Abschnitt 3.2.2: Feldreihenfolge Dürfen Absender in einer Nachricht NICHT mehrere Headerfelder mit demselben Feldnamen generieren, es sei denn, der gesamte Feldwert für dieses Headerfeld ist als durch Kommas getrennte Liste definiert, z.B. #(values)] oder das Header-Feld eine bekannte Ausnahme. Wenn Apigee Edge einen bestimmten Header, der keine Duplikate haben darf, mehr als einmal in der vom Client gesendeten HTTP-Anfrage findet, antwortet er mit 400 Bad Request und dem Fehlercode protocol.http.DuplicateHeader.

Mögliche Ursachen für diesen Fehler:

Allgemeine Diagnoseschritte

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

Ursache: Doppelter Header in Anfrage

Diagnose

1. Bestimmen Sie den Fehlercode und die Fehlerquelle für den beobachteten Fehler mithilfe von API-Monitoring oder NGINX-Zugriffslogs, wie unter Allgemeine Diagnoseschritte erläutert.
2. Wenn die Fehlerquelle den Wert apigee oder MP hat, weist dies darauf hin, dass die von der Clientanwendung an Apigee gesendete Anfrage doppelte Header enthält.

3. Sie können den tatsächlichen Header, der mehr als einmal als Teil der Anfrage gesendet wird, mit einer der folgenden Methoden ermitteln:

   Fehlermeldung

   Fehlermeldung

   1. Wenn Sie Zugriff auf die vollständige Fehlermeldung von Apigee Edge haben, lesen Sie die faultstring. faultstring enthält den Headernamen, der mehrmals gesendet wurde.

      Beispiel für eine Fehlermeldung:

      "faultstring":"Duplicate Header \"Expires\""
      

   2. In der obigen Fehlermeldung sehen Sie, dass der Header Expires mehr als einmal gesendet wird, wie in faultstring zu sehen.

   Tatsächliche Anfrage

   Tatsächliche Anfrage verwenden

   1. Wenn Sie Zugriff auf die eigentliche Anfrage der Clientanwendung haben, führen Sie die folgenden Schritte aus:

      1. Überprüfen Sie die Liste der Header, die in der Anfrage übergeben wurden.
      2. Wenn Sie feststellen, dass ein bestimmter Header mehr als einmal in der Anfrage mit demselben Wert oder unterschiedlichen Werten vorkommt, ist dies die Ursache für den Fehler.

      Beispielanfrage:

      curl https://HOST_ALIAS/duplicateheadertest -v -H "Expires: Mon, 21 June 2021 07:28:00 GMT" -H "Expires: Mon, 21 June 2021 07:28:00 GMT"
      

      In der obigen Beispielanfrage wird der Header Expires mehrmals gesendet. Daher schlägt diese Anfrage mit dem Fehler 400 Bad Request und dem Fehlercode protocol.http.DuplicateHeader fehl.

   2. Wenn Sie Zugriff auf die Clientlogs haben, können Sie alternativ sehen, ob Sie Informationen über die tatsächliche Anfrage an Apigee Edge haben, und den Header ermitteln, der mehr als einmal gesendet wird.

Auflösung

HTTPHeader.Expires=allowDuplicates, multiValued

Spezifikation

Apigee erwartet, dass die Clientanwendung gemäß den folgenden RFC-Spezifikationen keine doppelten Header als Teil der Anfrage sendet:

Wenn Sie weiterhin Unterstützung vom Apigee-Support benötigen, lesen Sie 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
• Führen Sie den Befehl curl aus, mit dem der Fehler 400 reproduziert wurde
• Ablaufverfolgungsdatei für die API-Anfragen

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

• Vollständige Fehlermeldung bei fehlgeschlagenen Anfragen
• Name der Umgebung
• API-Proxy-Bundle
• Führen Sie den Befehl curl aus, mit dem Sie den Fehler 400 reproduziert haben.
• Ablaufverfolgungsdatei für die API-Anfragen

• NGINX-Zugriffslogs:

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

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

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