500 Внутренняя ошибка сервера — EmptyPath

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

Симптом

Клиентское приложение получает код состояния HTTP 500 Internal Server Error с кодом ошибки protocol.http.EmptyPath в качестве ответа на вызовы API.

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

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

HTTP/1.1 500 Internal Server Error

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

{
   "fault":{
      "faultstring":"Request path cannot be empty",
      "detail":{
         "errorcode":"protocol.http.EmptyPath"
      }
   }
}

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

Эта ошибка возникает, если URL-адрес запроса внутреннего сервера, представленный переменной потока target.url , содержит пустой путь.

В соответствии со спецификациями RFC 3986, раздел 3: Синтаксические компоненты и RFC 3986, раздел 3.3: Путь :

1. Синтаксис URI состоит из следующих компонентов:

           foo://example.com:8042/over/there?name=ferret#nose
           \_/   \______________/\_________/ \_________/ \__/
            |            |            |            |       |
         scheme      authority       path        query   fragment
   

2. Компонент path является обязательным , и он ДОЛЖЕН всегда иметь косую черту ( / ), даже если в пути нет других символов.

Таким образом, если URL-адрес запроса внутреннего сервера вообще не содержит компонента path , то есть даже не имеет косой черты ( / ), то Apigee Edge отвечает 500 Internal Server Error и кодом ошибки protocol.http.EmptyPath .

Например: если target.url имеет значение https://www.mocktarget.apigee.net , то эта ошибка возникает как path компонент пуст или отсутствует.

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

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

Причина: URL-адрес внутреннего сервера (target.url) имеет пустой путь.

Диагностика

1. Определите код ошибки и источник ошибки для 500 Internal Server Error с помощью мониторинга API, инструмента трассировки или журналов доступа NGINX, как описано в разделе «Общие шаги диагностики» .
2. Если код ошибки — protocol.http.EmptyPath , а источник ошибки имеет значение target , это означает, что URL-адрес внутреннего сервера имеет пустой путь .

3. URL-адрес внутреннего сервера представлен переменной потока target.url в Apigee Edge. Эта ошибка обычно возникает, если вы пытаетесь обновить URL-адрес внутреннего сервера, то есть target.url , динамически с использованием любой политики (внутри прокси-сервера или общего потока) в целевом потоке запросов, так что у него пустой путь .

4. Определите, действительно ли переменная потока target.url имеет пустой путь и источник ее значения, выполнив один из следующих шагов:

   След

   Использование инструмента «Трассировка»

   Если вы записали трассировку этой ошибки, выполните действия, описанные в разделе «Использование инструмента трассировки» , и:

   1. Убедитесь, что в target.url указан пустой путь.

   2. Если да, то выясните, какая политика изменила или обновила значение target.url , чтобы оно содержало пустой путь.

      Пример трассировки, показывающий, что политика JavaScript обновила переменную потока target.url:

      
   3. Обратите внимание, что в приведенном выше примере трассировки политика JavaScript изменила или обновила значение target.url , чтобы оно содержало пустой путь.
   4. Обратите внимание, что target.url имеет следующие компоненты:
      • схема: https://mocktarget.apigee.net
      • путь: пустой

   Журналы

   Использование журналов на вашем сервере журналов

   1. Если у вас нет трассировки этой ошибки (периодическая проблема), проверьте, записали ли вы информацию о значении переменной потока target.url с помощью таких политик, как MessageLogging или ServiceCallout, на свой сервер журналов.
   2. Если у вас есть журналы, просмотрите их и:
      1. Проверьте, имеет ли target.url пустой путь, и
      2. Посмотрите, сможете ли вы определить, какая политика изменила target.url , чтобы он содержал пустой путь.

   API-прокси

   Проверка неисправного прокси-сервера API

   Если у вас нет трассировки или журналов этой ошибки, просмотрите неисправный прокси-сервер API, чтобы определить, что изменило или обновило переменную потока target.url , чтобы она содержала недопустимый путь. Проверьте следующее:

   • Политика в API-прокси
   • Любые общие потоки, вызываемые из прокси-сервера.

5. Внимательно изучите конкретную политику (например, AssignMessage или JavaScript), которая изменяет или обновляет переменную потока target.url , и определите причину обновления target.url до пустого пути.

   Вот несколько примеров политик, которые неправильно обновляют переменную потока target.url , чтобы она содержала пустой путь, что приводит к этой ошибке.

   Образец №1

   Пример № 1: Обновление политики JavaScript в переменной target.url

   var url = "https://mocktarget.apigee.net"
   context.setVariable("target.url", url);

   Обратите внимание, что в приведенном выше примере переменная потока target.url обновляется значением https://mocktarget.apigee.net , содержащимся в другой переменной url .

   Обратите внимание, что target.url имеет следующие компоненты:

   • схема: https://mocktarget.apigee.net
   • путь: пустой

   Поскольку путь пуст, Apigee Edge возвращает 500 Internal Server Error с кодом ошибки protocol.http.EmptyPath .

   Образец №2

   Пример № 2: Обновление политики JavaScript в переменной target.url

   var path = context.getVariable("request.header.Path");
   var url = "https://mocktarget.apigee.net" + path
   context.setVariable("target.url", url);

   Обратите внимание, что в приведенном выше примере переменная потока target.url обновляется путем объединения значения https://mocktarget.apigee.net , содержащегося в url переменной. url и значение другой переменной path , значение которой извлекается из request.header.Path .

   Если у вас есть доступ к фактическому запросу или трассировке, вы можете проверить фактическое значение, переданное в request.header.Path .

   Пример запроса, сделанного пользователем:

   curl -v https://HOST_ALIAS/v1/myproxy -H "Authorization: Bearer <token>
   

   В этом примере путь заголовка не отправляется как часть запроса. Следовательно, значение переменной path в политике JavaScript равно null .

   Так:

   • url = https://mocktarget.apigee.net + path
   • url = https://mocktarget.apigee.net + null
   • target.url = https://mocktarget.apigee.netnull

   Обратите внимание, что target.url имеет следующие компоненты:

   • схема: https://mocktarget.apigee.netnull
   • путь: пустой

   Образец №3

   Пример № 3. Политика AssignMessage обновляет переменную target.url через другую переменную.

   <AssignMessage async="false" continueOnError="false" enabled="true" name=">AM-SetTargetURL">
       <DisplayName>AM-SetTargetURL</DisplayName>
       <AssignVariable>
            <Name>target.url</Name>
            <Value>https://mocktarget.apigee.net</Value>
       </AssignVariable>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>

   Обратите внимание, что target.url имеет следующие компоненты:

   • схема: https://mocktarget.apigee.net
   • путь: пустой

   Во всех приведенных выше примерах путь в URL-адресе внутреннего сервера, то есть target.url , пуст, поэтому Apigee Edge возвращает 500 Internal Server Error с кодом ошибки protocol.http.EmptyPath .

Разрешение

В соответствии со спецификацией RFC 3986, раздел 2: Компоненты синтаксиса , компонент path является обязательным , и он ДОЛЖЕН всегда иметь косую черту (/), даже если в составе path нет других символов. Чтобы устранить эту проблему, выполните следующие действия:

1. Убедитесь, что URL-адрес внутреннего сервера, представленный переменной потока target.url всегда имеет непустой путь .
   1. В некоторых случаях в пути может отсутствовать имя ресурса, поэтому убедитесь, что путь имеет хотя бы косую черту ( / ).
   2. Если вы используете какие-либо другие переменные для определения значения переменной потока target.url , убедитесь, что другие переменные не имеют пустого пути.
   3. Если вы выполняете какие-либо строковые операции для определения значения переменной потока target.url , убедитесь, что результат или результат строковых операций не имеет пустой путь.
2. В примерах, обсуждаемых в разделе «Диагностика» , вы можете устранить эту проблему, как описано ниже:

   Образец №1

   Пример № 1: Обновление политики JavaScript в переменной target.url

   Добавьте косую черту ( / ) к url переменной, чтобы устранить эту проблему, как показано ниже:

   var url = "https://mocktarget.apigee.net/"
   context.setVariable("target.url", url);

   Образец №2

   Пример № 2: Обновление политики JavaScript в переменной target.url

   var path = context.getVariable("request.header.Path");
   var url = "https://mocktarget.apigee.net" + path
   context.setVariable("target.url", url);

   Убедитесь, что вы передали действительный путь, например /iloveapis , как часть Path заголовка запроса, чтобы устранить эту проблему, как показано ниже:

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

   curl -v https://HOST_ALIAS/v1/myproxy -H "Authorization: Bearer <token> -H "Path: /iloveapis"
   

   Образец №3

   Пример № 3. Политика AssignMessage обновляет переменную target.url через другую переменную.

   Добавьте допустимый путь в элемент <Value> политики AssignMessage. Например, вы можете иметь /json как путь к MockTarget API . То есть измените элемент <Value> на https://mocktarget.apigee.net/json , как показано ниже:

   <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-SetTargetURL">
       <DisplayName>AM-SetTargetURL</DisplayName>
       <AssignVariable>
            <Name>target.url</Name>
            <Value>https://mocktarget.apigee.net/json</Value>
       </AssignVariable>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>

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

Apigee Edge ожидает, что URL-адрес внутреннего сервера не имеет пустого пути в соответствии со следующими спецификациями:

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

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

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

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

• Название организации
• Имя среды
• Имя API-прокси
• Полная команда curl , используемая для воспроизведения 500 Internal Server Error с кодом ошибки protocol.http.EmptyPath
• Файл трассировки запросов API

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

• Полное сообщение об ошибке, наблюдаемое для неудачных запросов
• Имя среды
• Пакет прокси API
• Файл трассировки запросов 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

Ссылки