500 Erro interno do servidor - EmptyPath

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

Sintoma

O aplicativo cliente recebe um código de status HTTP de 500 Internal Server Error com o código de erro protocol.http.EmptyPath como uma resposta para chamadas de API.

Mensagem de erro

O aplicativo cliente recebe este código de resposta:

HTTP/1.1 500 Internal Server Error

Além disso, talvez você veja a seguinte mensagem de erro:

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

Causas possíveis

Esse erro ocorrerá se o URL da solicitação do servidor de back-end, representado pela variável de fluxo target.url, contiver um caminho vazio.

De acordo com as especificações, consulte RFC 3986, seção 3: componentes de sintaxe e RFC 3986, seção 3.3: caminho:

1. A sintaxe do URI tem os seguintes componentes:

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

2. O componente path é obrigatório e PRECISA sempre ter uma barra (/), mesmo que não haja outros caracteres como parte do caminho.

Portanto, se o URL de solicitação do servidor de back-end não tiver o componente path, ou seja, se não tiver uma barra (/), o Apigee Edge responderá com 500 Internal Server Error e código de erro protocol.http.EmptyPath.

Por exemplo: se target.url tiver o valor https://www.mocktarget.apigee.net, esse erro vai ocorrer porque o componente path está vazio ou faltando.

Causa	Descrição	Instruções de solução de problemas aplicáveis para
O URL do servidor de back-end (target.url) tem um caminho vazio	O URL do servidor de back-end representado pela variável de fluxo target.url tem um caminho vazio.	Usuários de nuvens públicas e privadas de borda

Etapas comuns do diagnóstico

Use uma das seguintes ferramentas/técnicas para diagnosticar esse erro:

Causa: o URL do servidor de back-end (target.url) tem um caminho vazio

Diagnóstico

1. Determine o código de falha e a origem da falha de 500 Internal Server Error usando os registros de acesso do NGINX, da ferramenta de rastreamento ou do Monitoring de API, conforme explicado em Etapas comuns de diagnóstico.
2. Se o Código de falha for protocol.http.EmptyPath e a Origem da falha tiver o valor target, isso indica que o URL do servidor de back-end tem um caminho vazio.

3. O URL do servidor de back-end é representado pela variável de fluxo target.url na Apigee Edge. Este erro geralmente acontece quando você tenta atualizar o URL do servidor de back-end, ou seja, target.url dinamicamente usando qualquer uma das políticas (dentro de proxy/fluxo compartilhado) no fluxo de solicitação de destino, de modo que ele tenha um caminho vazio.

4. Determine se a variável de fluxo target.url realmente tem um caminho vazio e a origem do valor dela usando uma das seguintes etapas:

   Trace

   Como usar a ferramenta Trace

   Se você capturou um rastro para esse erro, siga as etapas explicadas em Como usar a ferramenta de rastreamento e:

   1. Verifique se target.url tem um caminho vazio.

   2. Em caso afirmativo, descubra qual política modificou ou atualizou o valor de target.url para conter um caminho vazio.

      O rastro de exemplo que mostra a política JavaScript atualizou a variável de fluxo target.url:

      
   3. No trace de amostra acima, observe que a política de JavaScript modificou ou atualizou o valor de target.url para conter um caminho vazio.
   4. Observe que a target.url tem os seguintes componentes:
      • esquema: https://mocktarget.apigee.net
      • path: vazio

   Registros

   Como usar registros no servidor de registros

   1. Se você não tiver um trace para esse erro (um problema intermitente), verifique se você registrou as informações sobre o valor da variável de fluxo target.url usando políticas como MessageLogging ou Service callout para o servidor de registros.
   2. Se você tiver os registros, revise-os e faça o seguinte:
      1. Verifique se target.url tem um caminho vazio.
      2. Veja se é possível determinar qual política modificou target.url para conter um caminho vazio

   Proxy de API

   Como analisar o proxy de API com falha

   Se você não tiver um trace ou registros desse erro, analise o proxy de API com falha para determinar o que modificou ou atualizou a variável de fluxo target.url para conter um caminho inválido. Verifique os seguintes itens:

   • A política no proxy de API
   • Todos os fluxos compartilhados invocados pelo proxy

5. Analise a política específica (por exemplo, AttributionMessage ou JavaScript) que modifica ou atualiza a variável de fluxo target.url com cuidado e determine a causa da atualização de target.url para que ele tenha um caminho vazio.

   Confira alguns exemplos de políticas que atualizam incorretamente a variável de fluxo target.url para conter um caminho vazio que leva a esse erro.

   Amostra 1

   Exemplo 1: atualização da variável target.url da política de JavaScript

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

   No exemplo acima, observe que a variável de fluxo target.url é atualizada com o valor https://mocktarget.apigee.net contido em outra variável url.

   Observe que o target.url tem os seguintes componentes:

   • esquema: https://mocktarget.apigee.net
   • path: vazio

   Como o caminho está vazio, o Apigee Edge retorna 500 Internal Server Error com o código de erro protocol.http.EmptyPath.

   Amostra 2

   Exemplo 2: atualização da variável target.url da política de JavaScript

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

   No exemplo acima, observe que a variável de fluxo target.url é atualizada concatenando o valor https://mocktarget.apigee.net contido em uma variável url e o valor de outra variável path, cujo valor é recuperado de request.header.Path.

   Se você tiver acesso à solicitação ou ao trace real, poderá verificar o valor real transmitido para request.header.Path.

   Exemplo de solicitação feita pelo usuário:

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

   Neste exemplo, o caminho do cabeçalho não é enviado como parte da solicitação. Portanto, o valor do caminho da variável na política JavaScript é null.

   Portanto:

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

   Observe que target.url tem os seguintes componentes:

   • esquema: https://mocktarget.apigee.netnull
   • path: vazio

   Amostra 3

   Exemplo 3: política AttributionMessage atualizando a variável target.url com outra variável

   <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>
   

   Observe que target.url tem os seguintes componentes:

   • esquema: https://mocktarget.apigee.net
   • path: vazio

   Em todos os exemplos acima, o caminho no URL do servidor de back-end, ou seja, target.url, está vazio. Portanto, o Apigee Edge retorna 500 Internal Server Error com o código de erro protocol.http.EmptyPath.

Resolução

De acordo com a especificação RFC 3986, seção 2: componentes de sintaxe, o componente path é obrigatório e PRECISA sempre ter uma barra (/), mesmo que não haja outros caracteres como parte de path. Siga estas etapas para corrigir esse problema:

1. Verifique se o URL do servidor de back-end, representado pela variável de fluxo target.url sempre tem um caminho não vazio.
   1. Em alguns casos, pode ser que você não tenha um nome de recurso no caminho, então verifique se ele tem pelo menos uma barra (/).
   2. Se você usar outras variáveis para determinar o valor da variável de fluxo target.url, verifique se outras variáveis não têm um caminho vazio.
   3. Se você executar qualquer operação de string para determinar o valor da variável de fluxo target.url, verifique se o resultado ou resultado das operações de string não tem um caminho vazio.
2. Nos exemplos discutidos em Diagnóstico, é possível corrigir esse problema conforme explicado abaixo:

   Amostra 1

   Exemplo 1: atualização da variável target.url da política de JavaScript

   Adicione uma barra (/) à variável url para corrigir esse problema, conforme mostrado abaixo:

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

   Amostra 2

   Exemplo 2: atualização da variável target.url da política de JavaScript

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

   Transmita um caminho válido, por exemplo, /iloveapis como parte do cabeçalho da solicitação Path para corrigir esse problema, conforme mostrado abaixo:

   Exemplo de solicitação:

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

   Amostra 3

   Exemplo 3: política AttributionMessage atualizando a variável target.url por meio de outra variável

   Adicione um caminho válido no elemento <Value> da políticaAssignMessage. Por exemplo, você pode ter /json como o caminho para a API MockTarget. Ou seja, modifique o elemento <Value> para https://mocktarget.apigee.net/json, conforme mostrado abaixo:

   <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>
   

Especificação

O Apigee Edge espera que o URL do servidor de back-end não tenha um caminho vazio de acordo com as especificações a seguir:

Especificação
RFC 3986, seção 3: componentes de sintaxe
RFC 3986, seção 3.3: caminho

Se você ainda precisar de ajuda do suporte da Apigee, acesse Precisamos coletar informações de diagnóstico.

Coletar informações de diagnóstico

Se o problema persistir mesmo depois de seguir as instruções acima, colete as informações de diagnóstico a seguir e entre em contato com o suporte do Apigee Edge.

Se você for um usuário da nuvem pública, forneça as seguintes informações:

• Nome da organização
• Nome do ambiente
• Nome do proxy de API
• Completar o comando curl usado para reproduzir o 500 Internal Server Error com o código de erro protocol.http.EmptyPath
• Arquivo de rastreamento das solicitações de API

Se você for um usuário da nuvem privada, forneça as seguintes informações:

• Concluir a mensagem de erro observada para as solicitações com falha
• Nome do ambiente
• Pacote de proxy de API
• Arquivo de rastreamento das solicitações de API

• Registros de acesso do NGINX:

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

  Onde:ORG, ENV e PORT# são substituídos por valores reais.

• Registros do sistema do processador de mensagens /opt/apigee/var/log/edge-message- processor/logs/system.log

Referências

Variáveis de fluxo: meta