400 Неверный запрос — DuplicateHeader

Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee X.info

Симптом

В ответ на вызовы API клиентское приложение получает HTTP-статус 400 Bad Request с кодом ошибки protocol.http.DuplicateHeader .

Сообщение об ошибке

Клиентское приложение получает следующий код ответа:

HTTP/1.1 400 Bad Request

Кроме того, вы можете увидеть сообщение об ошибке, похожее на показанное ниже:

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

Возможные причины

Эта ошибка возникает, если определенный HTTP-заголовок, который не допускается к дублированию в Apigee Edge, встречается более одного раза с одинаковыми или разными значениями в HTTP-запросе, отправляемом клиентом в Apigee Edge.

В соответствии с RFC 7230, раздел 3.2.2: Порядок полей , отправитель НЕ ДОЛЖЕН генерировать несколько полей заголовка с одинаковым именем в сообщении, если только полное значение этого поля заголовка не определено как список, разделенный запятыми (например, #(значения)), или если поле заголовка не является известным исключением. Если Apigee Edge обнаруживает определенный заголовок, который не может иметь дубликатов, более одного раза в HTTP-запросе , отправленном клиентом, он отвечает кодом 400 Bad Request и кодом ошибки protocol.http.DuplicateHeader .

Вот возможные причины этой ошибки:

Общие этапы диагностики

Для диагностики этой ошибки воспользуйтесь одним из следующих инструментов/методов:

Причина: Дублирующийся заголовок в запросе

Диагноз

1. Определите код ошибки и источник ошибки, используя мониторинг API или журналы доступа NGINX, как описано в разделе «Общие шаги диагностики» .
2. Если в поле Fault Source указано значение apigee или MP , это означает, что запрос, отправленный клиентским приложением в Apigee, содержит повторяющиеся заголовки.

3. Определить фактический заголовок, отправляемый более одного раза в рамках запроса, можно одним из следующих способов:

   Сообщение об ошибке

   Используя сообщение об ошибке

   1. Если у вас есть доступ к полному сообщению об ошибке, полученному от Apigee Edge, обратитесь к faultstring ). faultstring содержит имя заголовка, который был отправлен более одного раза.

      Пример сообщения об ошибке:

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

   2. В приведенном выше сообщении об ошибке видно, что заголовок Expires отправляется более одного раза, как это видно из строки faultstring .

   Фактический запрос

   Используя фактический запрос

   1. Если у вас есть доступ к фактическому запросу, отправленному клиентским приложением, выполните следующие действия:

      1. Проверьте список заголовков, переданных в запросе.
      2. Если вы обнаружите, что определенный заголовок встречается в запросе более одного раза с одинаковым или разными значениями, то это и является причиной данной ошибки.

      Пример запроса:

      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"
      

      В приведенном выше примере запроса заголовок Expires отправляется более одного раза. Поэтому этот запрос завершается ошибкой 400 Bad Request и кодом ошибки: protocol.http.DuplicateHeader .

   2. В качестве альтернативы, если у вас есть доступ к журналам клиента, вы можете проверить, есть ли у вас информация о фактическом запросе, отправленном в Apigee Edge, и определить заголовок, который отправляется более одного раза.

Разрешение

HTTPHeader.Expires=allowDuplicates, multiValued

Спецификация

Согласно следующим спецификациям RFC, Apigee ожидает, что клиентское приложение не будет отправлять повторяющиеся заголовки в рамках запроса:

Если вам по-прежнему нужна помощь службы поддержки Apigee, перейдите по ссылке «Необходимо собрать диагностическую информацию» .

Необходимо собрать диагностическую информацию.

Соберите следующую диагностическую информацию, а затем свяжитесь со службой поддержки Apigee Edge .

Если вы являетесь пользователем публичного облака , предоставьте следующую информацию:

• Название организации
• Название среды
• Имя API-прокси
• Полная команда curl , использованная для воспроизведения ошибки 400
• Файл трассировки для запросов API

Если вы являетесь пользователем частного облака , предоставьте следующую информацию:

• Полное сообщение об ошибке, полученное для неудачных запросов.
• Название среды
• пакет API-прокси
• Полная команда curl , которую вы использовали для воспроизведения ошибки 400
• Файл трассировки для запросов API

• Журналы доступа NGINX:

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

  Где: ORG , ENV и PORT# заменяются фактическими значениями.

• Журналы системы обработки сообщений /opt/apigee/var/log/edge-message-processor/logs/system.log