Catálogo de errores del entorno de ejecución

Estás viendo la documentación de Apigee Edge.
Ve a la Documentación de Apigee X. información

Errores en Apigee Edge

Cuando se realizan solicitudes a la API a través de Apigee Edge, los componentes de Apigee Edge, como routers y procesadores de mensajes, o el backend los servidores pueden devolver errores a las aplicaciones cliente.

Errores de Message Processor

Message Processor es el componente central de Apigee Edge que procesa las políticas y interactúa con los servidores backend. Puede mostrar errores si detecta problemas como los que se mencionan a continuación:

  • Problemas de conectividad de red, fallas del protocolo de enlace TLS, falta de disponibilidad del servidor de backend, falta de respuesta durante la comunicación con el servidor de backend
  • Fallas durante la ejecución de la política
  • Los encabezados HTTP, la codificación, la ruta de acceso, el incumplimiento de las especificaciones de HTTP y los límites del producto, etc. no son válidos:
    • Con la solicitud HTTP que envían las aplicaciones cliente

      • O

    • Con la respuesta HTTP que envió el servidor de backend
  • Y mucho más

Error de muestra de Message Processor

Message Processor siempre muestra un código de estado HTTP seguido de un mensaje de error junto con un código de error en formato JSON como se muestra a continuación:

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

HTTP/1.1 414 Request-URI Too Long

Una respuesta de error de Message Processor aparece en el siguiente formato: 

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

Descripción de los campos en la respuesta de error:

Campo Descripción
faultstring Contiene el mensaje de error que describe la posible causa del error
errorcode Código de error (también conocido como código de falla) asociado con el error

Catálogo de errores del entorno de ejecución

Este catálogo de errores proporciona toda la información que necesitas sobre el entorno de ejecución código de error (para errores que no son de política) que muestra el mensaje de Apigee Edge Es el componente del procesador. Incluye la siguiente información para cada uno de los códigos de error:

  • Código de estado HTTP
  • Mensaje de error
  • Causas posibles del error
  • Cualquier límite de productos o especificaciones HTTP asociadas
  • Guías y videos que contienen instrucciones para diagnosticar la causa del error y las soluciones efectivas que puedes aplicar a fin de resolver el error por tu cuenta (cuando esté disponible)
  • Solución que puedes aplicar para resolver el error por tu cuenta

Se tratan las siguientes categorías de código de error:

Usa el cuadro Buscar que se encuentra a continuación para filtrar la tabla y mostrar la información anterior para un código de error específico. Puedes buscar el código de estado o cualquier contenido en cualquier campo de la tabla.

Código de error Descripción Corregir

flow.*

flow.APITimedOut
  • Código de estado HTTP:
 504 Gateway Timeout
  • Mensaje de error:
 API timed out
  • Causa posible:

Este error se produce si se produce una de las siguientes situaciones:

  • El servidor de backend no responde dentro del tiempo de espera configurado por la propiedad api.timeout para el proxy de API específico.
  • Una política tarda mucho tiempo debido a las operaciones que requieren mucha capacidad de procesamiento, una carga alta o un rendimiento bajo.

Nota: En esta guía, se proporcionan instrucciones para solucionar problemas relacionados con el código de error. messaging.adaptors.http.flow.GatewayTimeout; Sin embargo, puedes usar la misma guía para solucionar el problema del código de error flow.APITimedOut.

GUÍA

flow.SharedFlowNotFound
  • Código de estado HTTP:
 500 Internal Server Error
  • Mensaje de error:
 Shared Flow {shared_flow_name} Not Found
  • Causa posible:

Este error se produce si el flujo compartido específico es el siguiente:

  • No existe.

    • O

  • Existe, pero no se implementó
GUÍA

messaging.adaptors.http.flow

messaging.adaptors.http.flow.ApplicationNotFound
  • Código de estado HTTP:
 404 Not Found
  • Mensaje de error:
 Unable to identify proxy for host: {virtual_host} and url: {pathsuffix}
  • Causa posible:

Este error ocurre en una de las siguientes situaciones:

  1. El proxy de API específico es el siguiente:
    1. NO están configuradas para aceptar solicitudes Host virtual
    2. NO está configurada para aceptar solicitudes en la ruta específica. usado en la solicitud
    3. NO se implementa en el entorno específico en el que intentan hacer las solicitudes a la API
    4. NO se implementa en uno o más procesadores de mensajes
  2. El entorno específico en el que intentas hacer La solicitud a la API no se carga en uno o más Message Processor
 GUÍA
Este error también puede ocurrir si varios hosts virtuales tienen el mismo host. alias y número de puerto. GUÍA

messaging.adaptors.http.flow.DecompressionFailureAtRequest
  • Código de estado HTTP:
 400 Bad Request
  • Mensaje de error:
 Decompression failure at request
  • Causa posible:

Este error ocurre solo si se cumplen estas condiciones:

  • La codificación especificada en el encabezado de la solicitud HTTP Content-Encoding es válido y compatibles con Apigee Edge,

    • PERO

  • El formato de carga útil que envía el cliente como parte de la solicitud HTTP no coincide con el formato de codificación especificado en el encabezado Content-Encoding
GUÍA

messaging.adaptors.http.flow.DecompressionFailureAtResponse
  • Código de estado HTTP:
 502 Bad Gateway
  • Mensaje de error:
 Decompression failure at response
  • Causa posible:

Este error ocurre solo si se cumplen estas condiciones:

  • La codificación especificada en el backend del servidor El encabezado de respuesta HTTP Content-Encoding es válido y compatibles con Apigee Edge,

    • PERO

  • El formato de carga útil que envía el servidor de backend/destino como parte de la respuesta HTTP no coincide con el formato de codificación especificado en el encabezado Content-Encoding
GUÍA

messaging.adaptors.http.flow.ErrorResponseCode
  • Código de estado HTTP:
 500

GUÍA

VIDEO

  • Mensaje de error:
 El mensaje de error y el formato pueden variar según la implementación del servidor de backend.
  • Causa posible:
 Este error ocurre si el servidor de backend responde con un estado el código 500 a Apigee Edge.
  • Código de estado HTTP:
 503

GUÍA

VIDEO

  • Mensaje de error:
 El mensaje de error y el formato pueden variar según la implementación del servidor de backend.
  • Causa posible:
 Este error ocurre si el servidor de backend responde con un estado el código 503 a Apigee Edge.
  • Código de estado HTTP:
 504 GUÍA
  • Mensaje de error:
 El mensaje de error y el formato pueden variar según la implementación del servidor de backend.
  • Causa posible:
 Este error ocurre si el servidor de backend responde con un estado el código 504 a Apigee Edge.

Nota: El código de error messaging.adaptors.http.flow.ErrorResponseCode no se muestra como parte del mensaje de error enviado a las aplicaciones cliente. Este es ya que Apigee Edge establece este código de error cada vez que el servidor de backend responde con un error y cualquiera de los valores de 4XX o 5XX los códigos de estado. Puedes ver este código de error en la supervisión de API, los registros de acceso de NGINX, o una base de datos analítica.

messaging.adaptors.http.flow.GatewayTimeout
  • Código de estado HTTP:
 504 Gateway Timeout
  • Mensaje de error:
 Gateway Timeout
  • Causa posible:
 Este error ocurre si el servidor de backend no responde al Procesador de mensajes de Apigee Edge Es el período de tiempo de espera de E/S configurado en Message Processor.
GUÍA

messaging.adaptors.http.flow.LengthRequired
  • Código de estado HTTP:
 411 Length Required
  • Mensaje de error:
 'Content-Length' is missing
  • Causa posible:

Este error se produce si no pasa el encabezado Content-Length la aplicación cliente como parte de las solicitudes HTTP POST y PUT solicitudes enviadas a Apigee Edge.

Nota: Las solicitudes que fallan con este error no se pueden capturar en la herramienta Trace, ya que el procesador de mensajes realiza esta validación en una fase muy temprana, mucho antes de procesar la solicitud y ejecutar cualquier política en el proxy de API
  • Especificación de HTTP:
 Sección 3.3.2 de RFC: Longitud del contenido

Corregir

Para resolver este error, realiza los siguientes pasos:

  1. Asegúrate de que la aplicación cliente siempre pase el encabezado Content-Length como parte de POST de HTTP y Solicitudes PUT enviadas a Apigee Edge Por ejemplo:

    curl -X POST https://HOSTALIAS/PATH -d '{"name": "abc"}' -H "Content-Length: 15"

  2. Incluso si pasas una carga útil vacía con solicitudes POST y PUT, asegúrate de que el encabezado Content-Length: 0 se pase. Por ejemplo:

    curl -X POST https://HOSTALIAS/PATH -H "Content-Length: 0"

messaging.adaptors.http.flow.NoActiveTargets
  • Código de estado HTTP:
 503 Service Unavailable
  • Mensaje de error:
 The Service is temporarily unavailable
  • Causa posible:

Este error ocurre en una de las siguientes situaciones: si utilizas TargetServer en Apigee Edge:

  1. La resolución incorrecta de DNS del host del servidor de backend del servidor de autorización personalizado dio como resultado direcciones IP incorrectas, lo que genera errores de conexión.
  2. Errores de tiempo de espera de la conexión debido a los siguientes motivos:
    1. La restricción de firewall en el servidor de backend evita Apigee Edge no se conecte al servidor de backend.
    2. Problemas de conectividad de red entre Apigee Edge y el servidor de backend.
  3. El host especificado en TargetServer es incorrecto o tiene caracteres no deseados (como un espacio).

GUÍA

VIDEO
Este error también puede ocurrir si las verificaciones de estado configuradas para supervisar la verificación de estado de los servidores de destino fallan.

GUÍA

VIDEO

messaging.adaptors.http.flow.RequestTimeOut
  • Código de estado HTTP:
 408 Request Timeout
  • Mensaje de error:
 Request timed out
  • Causa posible:
 Este error ocurre si el procesador de mensajes de Apigee Edge no recibe el de solicitud de carga útil desde la aplicación cliente para la Período de tiempo de espera de E/S configurado en el componente Message Processor.

Corregir

Asegúrate de que la aplicación cliente envíe la carga útil de la solicitud dentro del Período de tiempo de espera de E/S configurado en el componente Message Processor de Apigee Edge.

messaging.adaptors.http.flow.ServiceUnavailable
  • Código de estado HTTP:
 503 Service Unavailable
  • Mensaje de error:
 The Service is temporarily unavailable
  • Causa posible:

Este error ocurre en una de las siguientes situaciones:

  1. La resolución de DNS incorrecta del host del servidor de backend por el servidor de autorización personalizado dio como resultado direcciones IP incorrectas, lo que genera errores de conexión.
  2. Errores de tiempo de espera de la conexión debido a los siguientes motivos:
    1. La restricción de firewall en el servidor de backend evita Apigee Edge no se conecte al servidor de backend.
    2. Problemas de conectividad de red entre Apigee Edge y servidor de backend.
  3. El host del servidor de destino especificado en el extremo de destino es incorrecto o tiene caracteres no deseados (como el espacio).

GUÍA

Error de DNS:

VIDEO

Conectividad de red:

VIDEO
Este error también puede ocurrir si el servidor de backend cierra la conexión antes de tiempo, mientras el procesador de mensajes aún envía la carga útil de la solicitud al servidor de backend. GUÍA

messaging.adaptors.http.flow.SslHandshakeFailed
  • Código de estado HTTP:
 503 Service Unavailable
  • Mensaje de error:
 SSL Handshake failed {error_message}
  • Causa posible:

Este error ocurre durante el proceso de protocolo de enlace SSL entre Envía mensajes al procesador y al servidor de backend en los siguientes casos:

  1. El almacén de confianza del procesador de mensajes de Apigee Edge tiene las siguientes características:
    • Contiene una cadena de certificados que no coincide con la del servidor backend cadena de certificados completa

      • O

    • No contiene la cadena de certificados completa del servidor de backend
  2. La cadena de certificados que presenta el servidor de backend:
    • Contiene un nombre de dominio completamente calificado (FQDN) que no coincide con el nombre de host especificado en el extremo de destino

      • O

    • Contiene una cadena de certificados incorrecta o incompleta

GUÍA

VIDEO

messaging.adaptors.http.flow.UnexpectedEOFAtTarget
  • Código de estado HTTP:
 502 Bad Gateway
  • Mensaje de error:
 Unexpected EOF at target
  • Causa posible:

Este error ocurre en una de las siguientes situaciones:

  1. TargetServer no está configurado correctamente para admitir conexiones TLS/SSL. en Apigee Edge.
  2. El servidor backend puede cerrar la conexión de forma abrupta mientras Apigee Edge espera una respuesta del servidor backend.
  3. Mantén los tiempos de espera activos en configuración incorrecta en Apigee y el servidor de backend.
GUÍA

messaging.runtime.*

messaging.runtime.RouteFailed
  • Código de estado HTTP:
 500 Internal Server Error
  • Mensaje de error:
 Unable to route the message to a TargetEndpoint
  • Causa posible:

Este error ocurre si Apigee Edge no puede enrutar la solicitud a ninguna de las TargetEndpoints porque:

  • No hay ninguna condición de regla de enrutamiento (<RouteRule>) que coincida con la solicitud en un proxy.

    • AND

  • No hay una regla de ruta predeterminada definida en el ProxyEndpoint (es decir, <RouteRule> sin ninguna condición)

Corregir

Para abordar este error, sigue estas instrucciones:

  1. Revisa las reglas de enrutamiento definidas en tu ProxyEndpoint y modifícalas para asegurarte de que haya al menos una condición de regla de enrutamiento que coincida con tu solicitud.
  2. Te recomendamos definir una regla de enrutamiento predeterminada sin condición cuando tienes varias RouteRules.
  3. Asegúrate de que la regla de ruta predeterminada se defina por última vez en la lista de rutas condicionales, ya que las reglas se evalúan de arriba a abajo en el ProxyEndpoint.

Para obtener más información sobre la definición de condiciones <RouteRule> en un ProxyEndpoint, consulta Objetivos condicionales.

messaging.runtime.SenseRaiseFault
  • Código de estado HTTP:
 403 Forbidden
  • Mensaje de error:
 Sense Fault
  • Causa posible:
 Este error ocurre si se realiza una solicitud a la API desde una dirección IP de cliente particular. que está bloqueado como parte de las reglas de Apigee Sense.

Corregir

Para abordar este error, sigue estas instrucciones:

  1. Verifica que hayas bloqueado la dirección IP de cliente específica. Para ello, haz lo siguiente: y comprobar las reglas configuradas en Apigee Sense. Si está bloqueado, entonces eso indica que funciona según lo diseñado.
  2. Si la dirección IP de cliente específica no está bloqueada, pero aún estás Si recibes este error, comunícate con el equipo de asistencia de Apigee Edge.

protocol.http.* - Caused due to bad request

protocol.http.BadFormData
  • Código de estado HTTP:
 500 Internal Server Error
  • Mensaje de error:
 Bad Form Data
  • Causa posible:

Este error se produce si y solo si se cumplen todas las siguientes condiciones:

  1. La solicitud HTTP que envió el cliente a Apigee Edge contiene:
    • Content-Type: application/x-www-form-urlencoded, y
    • Datos del formulario con el signo de porcentaje (%) o el signo de porcentaje (%) seguido de caracteres hexadecimales no válidos que no están permitidos según Formularios: Sección 17.13.4.1.
  2. El proxy de API en Apigee Edge lee el formulario específico. parámetros que contienen caracteres no permitidos con el Extrae variables o la política AssignMessage en el flujo de solicitud.
GUÍA

protocol.http.DuplicateHeader
  • Código de estado HTTP:
 400 Bad Request
  • Mensaje de error:
 Duplicate Header "{header_name}"
  • Causa posible:
 Este error ocurre si un encabezado HTTP específico no puede tener duplicados en Apigee Edge, aparece más de una vez con valores iguales o diferentes como parte del Solicitud HTTP enviada por la aplicación cliente a Apigee Edge.
  • Especificación de HTTP:
 RFC 7230, sección 3.2.2: Orden de los campos
GUÍA

protocol.http.EmptyHeaderName
  • Código de estado HTTP:
 400 Bad Request
  • Mensaje de error:
 Header name cannot be empty
  • Causa posible:
 Este error ocurre si el nombre del encabezado enviado como parte del código que la aplicación cliente solicita a Apigee Edge está vacía.
  • Especificación de HTTP:
 RFC 7230, sección 3.2: Campos de encabezado

Corregir

Asegúrate de que la solicitud HTTP que envió la aplicación cliente a Apigee Edge siempre contenga un nombre de encabezado válido según RFC 7230, sección 3.2: Campos de encabezado.

protocol.http.HeaderNameWithNonAsciiChar
  • Código de estado HTTP:
 400 Bad Request
  • Mensaje de error:
 Header {header_name} contains non ascii character {character}
  • Causa posible:
 Este error se produce si el nombre del encabezado enviado como parte de la solicitud HTTP que la aplicación cliente envía a Apigee Edge contiene caracteres que no son ASCII.
  • Especificación de HTTP:

RFC 7230, sección 3.2: campos de encabezado y RFC 7230, sección 3.2.6: componentes de valor de campo

Corregir

Asegúrate de que la solicitud HTTP del cliente se haya enviado al Apigee Edge no contiene caracteres que no son ASCII en los nombres de los encabezados, según RFC 7230, sección 3.2.6: Componentes de valores de campo

protocol.http.HeaderWithInvalidChar
  • Código de estado HTTP:
 400 Bad Request
  • Mensaje de error:
 Header {header_name} contains invalid character {character}
  • Causa posible:
 Este error se produce si el nombre del encabezado enviado como parte de la solicitud HTTP que la aplicación cliente envía a Apigee Edge contiene caracteres no válidos, como igual (=), coma (,), punto y coma (;), tabulador, CRLF y carácter de línea nueva.
  • Especificación de HTTP:

RFC 7230, sección 3.2: campos de encabezado y RFC 7230, sección 3.2.6: componentes de valor de campo

Corregir

Asegúrate de que la solicitud HTTP que envía la aplicación cliente a Apigee Edge no contienen caracteres no válidos en los nombres de los encabezados según RFC 7230, sección 3.2.6: Componentes de valores de campo

protocol.http.InvalidPath
  • Código de estado HTTP:
 400 Bad Request
  • Mensaje de error:
 Invalid path {path}
  • Causa posible:
 Este error se produce si la ruta en la URL de solicitud HTTP enviada por la aplicación cliente a Apigee Edge contiene caracteres que no están permitidos según la especificación RFC 3986, sección 3.3: Ruta de acceso.
  • Especificación de HTTP:

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

Corregir

Asegúrate de que la ruta en la URL de solicitud HTTP que envió el cliente aplicación a Apigee Edge no contiene caracteres no permitidos como según RFC 3986, sección 3.3: Ruta de acceso.

protocol.http.TooBigBody
  • Código de estado HTTP:
 413 Request Entity Too Large
  • Mensaje de error:
 Body buffer overflow
  • Causa posible:
 Este error se produce si el tamaño de la carga útil enviada por la aplicación cliente como parte del La solicitud HTTP a Apigee Edge supera el límite permitido en Apigee Edge.
  • Limites:
 Límites de Apigee Edge
GUÍA

protocol.http.TooBigHeaders
  • Código de estado HTTP:
 431 Request Header Fields Too Large
  • Mensaje de error:
 request headers size exceeding {limit}
  • Causa posible:
 El tamaño total de todos los encabezados de la solicitud que envió el cliente aplicación como parte de la solicitud HTTP a Apigee Edge es mayor que la cantidad permitida límite en Apigee Edge.
  • Especificación de HTTP:
 RFC 6585, sección 5: Campos de encabezado de solicitud 431 demasiado grandes
  • Limites:
 Límites de Apigee Edge
GUÍA

protocol.http.TooBigLine
  • Código de estado HTTP:
 414 Request-URI Too Long
  • Mensaje de error:
 request line size exceeding {limit}
  • Causa posible:
 Este error se produce si el tamaño de la línea de solicitud enviada por la aplicación cliente como parte de la solicitud HTTP a Apigee Edge es mayor que el límite permitido en Apigee Edge
  • Limites:
 Límites de Apigee Edge
GUÍA

protocol.http.UnsupportedEncoding
  • Código de estado HTTP:
 415 Unsupported Media
  • Mensaje de error:
 Unsupported Encoding "{encoding}"
  • Causa posible:
 Este error se produce si el encabezado Content-Encoding que envió el cliente como parte de la respuesta HTTP, contiene un formato de codificación/carga útil que no es compatibles con Apigee Edge.
  • Especificación de HTTP:
 RFC 7231, sección 6.5.13: 415 Tipo de medio no compatible
GUÍA

protocol.http.* - Caused by target

protocol.http.BadPath
  • Código de estado HTTP:
 500 Internal Server Error
  • Mensaje de error:
 Invalid request path
  • Causa posible:
 Este error se produce si la URL de la solicitud del servidor de backend, representada por la variable de flujo target.url, contiene una ruta de acceso que comienza con un signo de interrogación (?) en lugar de una barra diagonal (/) de reenvío, que no es válida.
  • Especificación de HTTP:

RFC 3986, sección 3: Componentes de sintaxis y RFC 3986, sección 3.3: Ruta de acceso
GUÍA

protocol.http.DuplicateHeader
  • Código de estado HTTP:
 502 Bad Gateway
  • Mensaje de error:
 Duplicate Header "{header_name}"
  • Causa posible:
 Este error se produce si el encabezado HTTP específico, que no puede tener duplicados, en Apigee Edge, aparece más de una vez con valores iguales o diferentes como parte de la respuesta HTTP que envía el servidor de backend a Apigee Edge.
  • Especificación de HTTP:
 RFC 7230, sección 3.2.2: Orden de los campos
GUÍA

protocol.http.EmptyHeaderName
  • Código de estado HTTP:
 502 Bad Gateway
  • Mensaje de error:
 Header name cannot be empty
  • Causa posible:
 Este error ocurre si el nombre del encabezado que envía el servidor de backend como parte del protocolo respuesta a Apigee Edge esté vacía.
  • Especificación de HTTP:
 RFC 7230, sección 3.2: Campos de encabezado

Corregir

Asegúrate de que la respuesta HTTP que envió el backend servidor a Apigee Edge siempre contendrá un nombre de encabezado válido según RFC 7230, sección 3.2: Campos de encabezado.

protocol.http.EmptyPath
  • Código de estado HTTP:
 500 Internal Server Error
  • Mensaje de error:
 Request path cannot be empty
  • Causa posible:
 Este error se produce si la URL de la solicitud HTTP del servidor de backend, representada por la variable de flujo target.url, contiene una ruta de acceso vacía.
  • Especificación de HTTP:

RFC 3986, sección 3: Componentes de sintaxis y RFC 3986, sección 3.3: Ruta de acceso
GUÍA

protocol.http.HeaderNameWithNonAsciiChar
  • Código de estado HTTP:
 502 Bad Gateway
  • Mensaje de error:
 Header {header_name} contains non ascii character {character}
  • Causa posible:
 Este error se produce si el nombre del encabezado que envía el servidor de backend como parte de la respuesta HTTP a Apigee Edge contiene caracteres que no son ASCII.
  • Especificación de HTTP:

RFC 7230, sección 3.2: campos de encabezado y RFC 7230, sección 3.2.6: componentes de valor de campo

Corregir

Asegúrate de que la respuesta HTTP del servidor backend se envíe al Apigee Edge no contiene caracteres que no son ASCII en los nombres de los encabezados, según RFC 7230, sección 3.2.6: Componentes de valores de campo

protocol.http.HeaderWithInvalidChar
  • Código de estado HTTP:
 502 Bad Gateway
  • Mensaje de error:
 Header {header_name} contains invalid character {character}
  • Causa posible:
 Este error se produce si el nombre del encabezado que envía el servidor de backend como parte de la respuesta HTTP contiene caracteres no válidos, como igual (=), coma (,), punto y coma (;), tabulación, CRLF y carácter de salto de línea
  • Especificación de HTTP:

RFC 7230, sección 3.2: campos de encabezado y RFC 7230, sección 3.2.6: componentes de valor de campo

Corregir

Asegúrate de que la respuesta HTTP del servidor de backend que se envía a Apigee Edge no contenga ningún caracteres no válidos en los nombres de encabezado según RFC 7230, sección 3.2.6: Componentes de valores de campo

protocol.http.ProxyTunnelCreationFailed
  • Código de estado HTTP:
 503 Service Unavailable
  • Mensaje de error:
 Proxy refused to create tunnel with response status {status code}
  • Causa posible:

Este error ocurre durante la creación del túnel entre Apigee Edge y servidor de backend por el servidor proxy debido al firewall, LCA (lista de control de acceso), DNS problemas, disponibilidad de la disponibilidad del servidor de backend, etcétera.

Nota: El código de estado en el mensaje de error (faultstring) proporciona la causa de alto nivel del problema.
GUÍA

protocol.http.Response306Reserved
  • Código de estado HTTP:
 502 Bad Gateway
  • Mensaje de error:
 Response Status code 306 is reserved, so can't be used.
  • Causa posible:

Este error ocurre si el servidor de backend respondió con Código de estado 306 a Apigee Edge

El código de estado 306 se definió en una versión anterior de la especificación HTTP. Según la especificación HTTP actual, este código está reservado y no debe usarse.
  • Especificación de HTTP:
 RFC 7231, sección 6.3.5: 306 Reservado

Corregir

Dado que el código de estado 306 está reservado, asegúrate de que tu servidor de backend no usa este código de estado mientras envía un respuesta a Apigee Edge.

protocol.http.Response405WithoutAllowHeader
  • Código de estado HTTP:
 502 Bad Gateway
  • Mensaje de error:
 Received 405 Response without Allow Header
  • Causa posible:
 El servidor de backend responde con el código de estado 405 Method Not Allowed sin el encabezado "Allow".
  • Especificación de HTTP:

RFC 7231, sección 6.5.5: Método no permitido 405 y RFC 7231, sección 7.4.1: Permitir
GUÍA

protocol.http.ResponseWithBody
  • Código de estado HTTP:
 502 Bad Gateway
  • Mensaje de error:
 Received {status_code} Response with message body
  • Causa posible:

Este error ocurre si la respuesta HTTP del servidor de backend a Apigee Edge está ya sea 204 No Content o 205 Reset Content, pero contiene las cuerpo de la respuesta o uno o más de los siguientes encabezados:

  • Content-Length
  • Content-Encoding
  • Transfer-Encoding
  • Especificación de HTTP:

RFC 7231, sección 6.3.5: 204 Ningún contenido y RFC 7231, sección 6.3.6: 205 Restablecer contenido
GUÍA

protocol.http.TooBigBody
  • Código de estado HTTP:
 502 Bad Gateway
  • Mensaje de error:
 Body buffer overflow
  • Causa posible:
 Este error se produce si el tamaño de la carga útil enviada por la aplicación cliente como parte del La solicitud HTTP a Apigee Edge supera el límite permitido en Apigee Edge.
  • Limites:
 Límites de Apigee Edge
GUÍA

protocol.http.TooBigHeaders
  • Código de estado HTTP:
 502 Bad Gateway
  • Mensaje de error:
 response headers size exceeding {limit}
  • Causa posible:
 Este error se produce si el tamaño total de todos los encabezados de respuesta enviados por el de backend como parte de la respuesta HTTP a Apigee Edge es mayor que límite permitido en Apigee Edge.
  • Limites:
 Límites de Apigee Edge
GUÍA

protocol.http.TooBigLine
  • Código de estado HTTP:
 502 Bad Gateway
  • Mensaje de error:
 response line size exceeding {limit}
  • Causa posible:
 Este error ocurre si el tamaño de la línea de respuesta que envía el servidor backend como parte de la respuesta HTTP a Apigee Edge supera el límite permitido en Apigee Edge.
  • Limites:
 Límites de Apigee Edge
GUÍA

protocol.http.UnsupportedEncoding
  • Código de estado HTTP:
 415 Unsupported Media
  • Mensaje de error:
 Unsupported Encoding "{encoding}"
  • Causa posible:
 Este error se produce si el encabezado Content-Encoding enviado por el de backend como parte de la respuesta HTTP contiene la codificación que no es compatibles con Apigee Edge.
  • Especificación de HTTP:
 RFC 7231, sección 6.5.13: 415 Tipo de medio no compatible
GUÍA

security.util.*

security.util.KeyAliasNotFound
  • Código de estado HTTP:
 500 Internal Server Error
  • Mensaje de error:
 KeyAlias {KeyAlias_name} is not found in Keystore {Keystore_Name}
  • Causa posible:

Este error se produce si no se encuentra el KeyAlias específico al que se hace referencia en el TargetEndpoint o TargetServer en el almacén de claves específico.

Corregir

Asegúrate de que el KeyAlias especificado en TargetEndpoint o TargetServer exista y sea parte del almacén de claves específico.

security.util.TrustStoreWithNoCertificates
  • Código de estado HTTP:
 500 Internal Server Error
  • Mensaje de error:
 TrustStore {truststore_name} has no certificates
  • Causa posible:

Este error se produce si el Truststore específico al que se hace referencia en el TargetEndpoint o TargetServer no contiene ningún certificado.

Corregir

Si deseas validar el certificado del servidor de backend y deseas usar el almacén de confianza en un TargetEndpoint o TargetServer, asegúrate de que el almacén de confianza contenga los certificados válidos del servidor de backend.