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

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

Симптом

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

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

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

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

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

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

Если вам по-прежнему нужна помощь службы поддержки 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