Error interno del servidor - BadPath

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X. Información

Síntoma

La aplicación cliente obtiene un código de estado HTTP de 500 Internal Server Error con el código de error protocol.http.BadPath como respuesta a las llamadas a la API.

Mensaje de error

La aplicación cliente obtiene el siguiente código de respuesta:

HTTP/1.1 500 Internal Server Error

Además, es posible que veas el siguiente mensaje de error:

{
   "fault":{
      "faultstring":"Invalid request path",
      "detail":{
         "errorcode":"protocol.http.BadPath"
      }
   }
}

Causas posibles

Este error se produce si la URL de la solicitud del servidor de backend, representada por la variable de flujo target.url, contiene un path que comienza con un signo de interrogación (?) en lugar de una barra diagonal (/), que no es válido.

Según las especificaciones de RFC 3986, sección 3: Componentes de la sintaxis y RFC 3986, sección 3.3: Ruta de acceso:

1. La sintaxis del URI tiene los siguientes componentes:

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

2. El componente path es obligatorio y DEBE comenzar con una barra diagonal (/) y siempre debe tener una.

Por lo tanto, si la URL de la solicitud del servidor de backend tiene un componente path que comienza con un signo de interrogación (?) en lugar de una barra diagonal (/), Apigee Edge responde con 500 Internal Server Error y el código de error protocol.http.BadPath.

Por ejemplo, si target.url tiene el valor https://www.mocktarget.apigee.net?json, se produce este error cuando se determina que path no es no válido, ya que comienza con un signo de interrogación (?) en lugar de una barra diagonal (/).

Causa	Descripción	Instrucciones de solución de problemas aplicables para
La URL del servidor de backend (target.url) tiene una ruta no válida	El componente de ruta de acceso en la URL del servidor de backend representado por la variable de flujo target.url comienza con un signo de interrogación (?) en lugar de una barra diagonal (/).	Usuarios de la nube pública y privada de Edge

Pasos comunes de diagnóstico

Usa una de las siguientes herramientas o técnicas para diagnosticar este error:

Causa: La URL del servidor de backend (target.url) tiene una ruta no válida.

Diagnóstico

1. Determina el código de error y la fuente de errores para 500 Internal Server Error mediante la supervisión de la API, la herramienta de seguimiento o los registros de acceso de NGINX, como se explica en Pasos comunes de diagnóstico.
2. Si el código de falla es protocol.http.BadPath y la fuente de errores tiene el valor target, esto indica que la URL del servidor de backend tiene una ruta de acceso no válida.

3. La URL del servidor de backend se representa con la variable de flujo target.url en Apigee Edge. Por lo general, este error ocurre si intentas actualizar la URL del servidor de backend (target.url) de forma dinámica con cualquiera de las políticas (dentro del proxy/flujo compartido) en el flujo de solicitudes de destino, de modo que tenga una ruta de acceso no válida.

4. Determina si la variable de flujo target.url tiene una ruta de acceso no válida y el origen de su valor mediante uno de los siguientes métodos:

   Trace

   Cómo usar la herramienta Trace

   Si capturaste un seguimiento para este error, sigue los pasos que se explican en Usa la herramienta de seguimiento .

   1. Verifica si target.url tiene una ruta no válida, es decir, si comienza con un signo de interrogación (?) en lugar de una barra diagonal (/).

   2. Si es así, averigua qué política modificó o actualizó el valor de target.url para que contenga una ruta no válida.

      Seguimiento de ejemplo que muestra que la política de JavaScript actualizó la variable de flujo target.url

      
   3. En el seguimiento de muestra anterior, observa que la política de JavaScript modificó o actualizó el valor de target.url para que contenga una ruta no válida.
   4. Ten en cuenta que target.url tiene los siguientes componentes:
      • esquema: https
      • autoridad: mocktarget.apigee.net
      • ruta de acceso: ?json

      La ruta comienza con un signo de interrogación (?) en lugar de una barra diagonal (/); por lo tanto, no es válida.

   Registros

   Usa registros en tu servidor de registros

   1. Si no tienes un seguimiento para este error (un problema intermitente), verifica si registraste la información sobre el valor de la variable de flujo target.url mediante políticas como MessageLogging o la política ServiceReferencia en tu servidor de registros.
   2. Si tienes los registros, revísalos y haz lo siguiente:
      1. Verifica si target.url tiene una ruta no válida.
      2. Intenta determinar la información sobre qué política modificó target.url para que contenga una ruta no válida.

   proxy de API

   Revisa el proxy de API con errores

   Si no tienes un seguimiento o registros para este error, revisa el proxy de API con errores a fin de determinar qué modificó o actualizó la variable de flujo target.url para que contenga una ruta de acceso no válida. Verifica lo siguiente:

   • La política dentro del proxy de API
   • Cualquier flujo compartido invocado desde el proxy

5. Examina atentamente la política específica (por ejemplo,AssignMessage o JavaScript) que modifica o actualiza la variable de flujo target.url y determina la causa de la actualización de target.url para que tenga una ruta de acceso no válida.

   Estas son algunas políticas de ejemplo que actualizan la variable de flujo target.url de forma incorrecta para contener una ruta no válida que genera este error.

   Ejemplo 1

   Ejemplo 1: Actualización de la variable target.url de la política de JavaScript

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

   En el ejemplo anterior, ten en cuenta que la variable de flujo target.url se actualiza con el valor https://mocktarget.apigee.net?json contenido en otra variable url..

   Ten en cuenta que el valor de url tiene los siguientes componentes:

   • esquema: https
   • autoridad: mocktarget.apigee.net
   • ruta de acceso: ?json

   La ruta comienza con un signo de interrogación (?) en lugar de una barra diagonal (/), que no es válida. Por lo tanto, Apigee Edge muestra 500 Internal Server Error con el código de error protocol.http.BadPath.

   Muestra n.o 2

   Ejemplo 2: Política de JavaScript actualizando la variable target.url según el valor en el encabezado de la solicitud

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

   En el ejemplo anterior, observa que la variable de flujo target.url se actualiza mediante la concatenación del valor https://mocktarget.apigee.net contenido en una variable url y el valor de otra variable path, cuyo valor se recupera de request.header.Path..

   Si tienes acceso a la solicitud o al seguimiento real, puedes verificar el valor real que se pasa a request.header.Path.

   Ejemplo de solicitud que realizó el usuario

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

   En este ejemplo, la ruta de acceso del encabezado no se envía como parte de la solicitud. Por lo tanto, el valor de la variable path en la política de JavaScript es null.

   Entonces:

   • url = https://mocktarget.apigee.net + path
   • url = https://mocktarget.apigee.net + "?user"
   • target.url = https://mocktarget.apigee.net?user

   Ten en cuenta que el valor de target.url tiene los siguientes componentes:

   • esquema: https
   • autoridad: mocktarget.apigee.net
   • ruta de acceso: ?user

   La ruta comienza con un signo de interrogación (?) en lugar de una barra diagonal (/), que no es válida. Por lo tanto, Apigee Edge muestra 500 Internal Server Error con el código de error protocol.http.BadPath.

   Ejemplo 3

   Muestra n.o 3: Política de AttributionMessage actualizando la variable 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?echo</Value>
       </AssignVariable>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>
   

   Ten en cuenta que el valor de url tiene los siguientes componentes:

   • esquema: https
   • autoridad: mocktarget.apigee.net
   • ruta de acceso: ?echo

   Nuevamente en este ejemplo, la ruta comienza con un signo de interrogación (?) en lugar de una barra diagonal (/), que no es no válida. Por lo tanto, Apigee Edge muestra 500 Internal Server Error con el código de error protocol.http.BadPath.

Resolución

Según la especificación de URL RFC 3986, sección 3: Componentes de la sintaxis, el componente path es obligatorio y siempre DEBE comenzar con "/". Por lo tanto, sigue estos pasos para solucionar el problema:

1. Asegúrate de que la URL del servidor de backend, representada por la variable de flujo target.url, siempre tenga una ruta de acceso válida y siempre comience con una barra diagonal (/).
   1. En algunos casos, es posible que no tengas un nombre de recurso en la ruta de acceso. Luego, asegúrate de que la ruta tenga al menos una barra diagonal (/).
   2. Si usas otras variables para determinar el valor de la variable de flujo target.url, asegúrate de que otras variables no tengan una ruta de acceso no válida.
   3. Si realizas alguna operación de string para determinar el valor de la variable de flujo target.url, asegúrate de que el resultado de las operaciones de string no tenga una ruta de acceso no válida.

2. En los ejemplos analizados anteriormente, puedes solucionar este problema de la manera que se explica a continuación:

   Ejemplo 1

   Ejemplo 1: Actualización de la variable target.url de la política de JavaScript

   Usa una barra diagonal (/) en lugar de un signo de interrogación (?) en la variable url para solucionar este problema, como se muestra a continuación:

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

   Muestra n.o 2

   Ejemplo 2: Política de JavaScript actualizando la variable target.url según el valor en el encabezado de la solicitud

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

   Asegúrate de pasar una ruta de acceso válida, por ejemplo, /user como parte del encabezado de solicitud Path para solucionar este problema, como se muestra a continuación:

   Solicitud de muestra:

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

   Ejemplo 3

   Muestra n.o 3: Política deAssignMessage actualizando la variable target.url

   Agrega una ruta de acceso válida en el elemento <Value> de la políticaAssignMessage. Es decir, reemplaza el signo de interrogación (?) por una barra diagonal (/) en el elemento <Value> y configúralo en https://mocktarget.apigee.net/echo para solucionar este problema como se muestra a continuación:

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

   Especificación

   Apigee Edge espera que el path componente de la URL del servidor de backend DEBE comenzar siempre con una barra diagonal (/) según las siguientes especificaciones:

   Especificación
   RFC 3986, sección 3: Componentes de la sintaxis
   RFC 3986, sección 3.3: Ruta de acceso

   Si aún necesitas asistencia de la asistencia de Apigee, consulta Debes recopilar información de diagnóstico.

   Se debe recopilar información de diagnóstico

   Si el problema persiste, incluso después de seguir las instrucciones anteriores, recopila la siguiente información de diagnóstico y, luego, comunícate con el equipo de asistencia de Apigee Edge:

   Si eres un usuario de la nube pública, proporciona la siguiente información:

   • Nombre de la organización
   • Nombre del entorno
   • Nombre del proxy de API
   • Completa el comando curl que se usa para reproducir 500 Internal Server Error con el código de error protocol.http.BadPath.
   • Archivo de seguimiento para las solicitudes a la API

   Si eres un usuario de la nube privada, proporciona la siguiente información:

   • Mensaje de error completo observado para las solicitudes con errores
   • Nombre del entorno
   • Paquete de proxy de API
   • Archivo de seguimiento para las solicitudes a la API

   • Registros de acceso de NGINX:

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

     Dónde: Se reemplazan ORG, ENV y PORT# por valores reales.

   • Registros del sistema del procesador de mensajes /opt/apigee/var/log/edge-message- processor/logs/system.log

   Referencias

   Variables de flujo: objetivo