431 Слишком большие поля заголовка запроса — TooBigHeaders

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

Симптом

Клиентское приложение получает код состояния HTTP 431 Request Header Fields Too Large с кодом ошибки protocol.http.TooBigHeaders в качестве ответа на вызовы API.

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

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

HTTP/1.1 431 Request Header Fields Too Large

Кроме того, вы можете увидеть следующее сообщение об ошибке:

{
   "fault":{
      "faultstring":"request headers size exceeding 25,600",
      "detail":{
         "errorcode":"protocol.http.TooBigHeaders"
      }
   }
}

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

Эта ошибка возникает, если общий размер всех заголовков запросов, отправленных клиентским приложением в Apigee Edge как часть HTTP-запроса, превышает допустимый предел в Apigee Edge согласно RFC 6585, раздел 5: 431 Request Header Fields Too Large .

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

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

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

Причина: размер заголовков запросов превышает допустимый предел.

Диагностика

1. Определите код ошибки , источник ошибки и размер запроса для наблюдаемой ошибки с помощью журналов мониторинга API или доступа NGINX, как описано в разделе «Общие шаги диагностики» .
2. Если источник сбоя имеет значение apigee или MP , код сбоя имеет значение protocol.http.TooBigHeaders , а длина запроса превышает 25 КБ, то это указывает на то, что размер запроса, отправленного клиентским приложением в Apigee, больше, чем размер запроса. разрешенный лимит в Apigee Edge .
3. Вы можете проверить, что размер заголовков запроса превысил разрешенный предел в 25 КБ, используя один из следующих методов:

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

   Чтобы подтвердить использование сообщения об ошибке:

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

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

   "faultstring":"request headers size exceeding 25,600"

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

   Чтобы подтвердить использование фактического запроса:

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

   1. Проверьте размер заголовков, переданных в запросе.

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

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

      curl -v https://HOSTALIAS/test -H "header0: 000000000000000000……..000000<trimmed>" -H "header1: 111111111111111111……..111111<trimmed>" -H "header2: 222222222222222222……..222222<trimmed>"-H "header3: 333333333333333333……..333333<trimmed>"
      

      В приведенном выше случае общий размер заголовков header0 , header1 , header2 и header3 превышает 25 КБ, то есть содержит более 25 тыс. символов ASCII (байт).

      Если вы используете какой-либо другой клиент, вы можете просмотреть журналы клиента и попытаться узнать размер строки запроса, отправляемой в Apigee Edge.

   Журналы процессора сообщений

   Для проверки с использованием журналов процессора сообщений:

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

   1. Проверьте журналы процессора сообщений:

      /opt/apigee/var/log/edge-message-processor/logs/system.log

   2. Выполните поиск, чтобы узнать, возникли ли какие-либо ошибки 431 в течение определенного периода времени (если проблема возникла в прошлом) или есть ли какие-либо запросы, которые по-прежнему завершаются с ошибкой 431 . Вы можете использовать следующие строки поиска.

      grep -ri "exceeding"
      

      grep -ri "RequestHeadersTooLarge"
      

   3. Вы найдете строки из system.log , подобные следующим:

      2021-07-27 08:30:28,419  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() :
      Request:GET, uri:/test/, message Id:null,
      exception:com.apigee.errors.http.user.RequestHeadersTooLarge{
      code = protocol.http.TooBigHeaders, message = request headers size
      exceeding 25,600, associated contexts = []}, context:Context@9c5903
      input=ClientInputChannel(SSLClientChannel[Accepted:
      Remote:192.168.205.251:8443 Local:192.168.67.23:22188]@25130
      useCount=1 bytesRead=0 bytesWritten=15367 age=667062ms  lastIO=0ms
      isOpen=true)

      Текстовое message = request headers size exceeding 25,600 в приведенном выше сообщении об ошибке означает, что общий размер заголовков запроса превышает 25 КБ. Таким образом, Apigee Edge генерирует исключение com.apigee.errors.http.user.RequestHeadersTooLarge и возвращает код состояния 431 с кодом ошибки protocol.http.TooBigHeaders клиентским приложениям.

Разрешение

Пределы

Apigee ожидает, что клиентское приложение и внутренний сервер не будут отправлять заголовки запроса/ответа, размеры которых превышают допустимый предел, как указано в разделе «Ограничение размера заголовка запроса/ответа» в Apigee Edge Limits .

1. Если вы являетесь пользователем общедоступного облака , то максимальный предел размера заголовков запросов и ответов соответствует размеру заголовка запроса/ответа, указанному в Apigee Edge Limits .
2. Если вы являетесь пользователем частного облака, возможно, вы изменили максимальный предел по умолчанию для размера заголовков запросов и ответов (хотя это не рекомендуется). Вы можете определить максимальный размер заголовка запроса, следуя инструкциям в разделе «Как проверить текущий предел» .

Как проверить текущий лимит?

В этом разделе объясняется, как проверить, что свойство HTTPRequest.headers.limit обновлено новым значением в процессорах сообщений.

1. На компьютере с процессором сообщений найдите свойство HTTPRequest.headers.limit в каталоге /opt/apigee/edge-message-processor/conf и проверьте, какое значение было установлено, как показано ниже:

   grep -ri "HTTPRequest.headers.limit" /opt/apigee/edge-message-processor/conf
   

2. Пример результата выполнения приведенной выше команды выглядит следующим образом:

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPRequest.headers.limit=25k

3. Обратите внимание, что в приведенном выше примере вывода свойству HTTPRequest.headers.limit присвоено значение 25k в http.properties .

   Это указывает на то, что ограничение размера заголовка запроса, настроенного в Apigee для частного облака, составляет 25 КБ.

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

Apigee Edge ожидает, что клиентское приложение не будет отправлять заголовки большого размера в составе запроса. Если запрос содержит заголовки, общий размер которых превышает указанный предел, Apigee выдает 431 Request Header Fields Too Large в соответствии со следующими спецификациями RFC:

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

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

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

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

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

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

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

• Журналы доступа 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