502 Bad Gateway - TooBigBody

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 502 Bad Gateway con el código de error protocol.http.TooBigBody 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 502 Bad Gateway

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

{
   "fault":{
      "faultstring":"Body buffer overflow",
      "detail":{
         "errorcode":"protocol.http.TooBigBody"
      }
   }
}

Causas posibles

Este error ocurre si el tamaño de la carga útil que envió el servidor de destino o backend a Apigee Edge como parte de la respuesta HTTP supera el límite permitido en Apigee Edge.

Estas son las posibles causas del error:

Causa	Descripción	Instrucciones de solución de problemas aplicables para
El tamaño de la carga útil de la respuesta es mayor que el límite permitido	El tamaño de la carga útil que envía el servidor de destino/backend como parte de la respuesta HTTP a Apigee supera el límite permitido en Apigee.	Usuarios de la nube pública y privada de Edge
El tamaño de la carga útil de la respuesta supera el límite permitido después de la descompresión	El tamaño de la carga útil que envía el servidor de destino o backend como parte de la respuesta HTTP a Apigee en formato comprimido supera el límite permitido cuando lo descomprime Apigee.	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: El tamaño de la carga útil de la respuesta supera el límite permitido.

Diagnóstico

1. Determina el código de falla, la fuente de la falla y el tamaño de la carga útil de la respuesta del error observado con la supervisión de la API, la herramienta Trace o los registros de acceso de NGINX, como se explica en Pasos comunes de diagnóstico de la situación n.o 1.
2. Si la fuente de errores tiene el valor target, esto indica que el tamaño de la carga útil de la respuesta que envía el servidor de destino/backend a Apigee es mayor que el límite permitido en Apigee Edge.
3. Verifica el Tamaño de la carga útil de la respuesta según lo determinado en el paso 1.
   • Si el tamaño de la carga útil supera el límite permitido de 10 MB, esa es la causa del error.
   • Si el límite permitido de tamaño de la carga útil es de alrededor de 10 MB, es posible que la carga útil de respuesta se pase en formato comprimido. Ve a Causa: El tamaño de la carga útil de la respuesta supera el límite permitido después de la descompresión.
4. Para validar que el tamaño de la carga útil de la respuesta sea superior al límite permitido de 10 MB, verifica la respuesta real mediante los siguientes pasos:
   1. Si no tienes acceso a la solicitud real realizada al servidor de destino o backend, ve a Resolución.
   2. Si tienes acceso a la solicitud real realizada al servidor de destino o backend, realiza los siguientes pasos:
      1. Si eres un usuario de nube pública o nube privada, realiza una solicitud directamente al servidor de backend desde el servidor de backend o desde cualquier otra máquina desde la que puedas realizar la solicitud al servidor de backend.
      2. Si eres un usuario de la nube privada, también puedes realizar la solicitud al servidor de backend desde uno de los procesadores de mensajes.
      3. Verifica el tamaño de la carga útil que se pasó en la respuesta en el encabezado Content-Length.
      4. Si descubres que el tamaño de la carga útil supera el límite permitido en Apigee Edge, entonces esa es la causa del problema.

   Respuesta de muestra del servidor de backend:

   curl -v https://BACKENDSERVER-HOSTNAME/testfile
   

   * About to connect() to 10.14.0.10 port 9000 (#0)
   *   Trying 10.14.0.10...
   * Connected to 10.14.0.10 (10.148.0.10) port 9000 (#0)
   > GET /testfile HTTP/1.1
   > User-Agent: curl/7.29.0
   > Host: 10.14.0.10:9000
   > Accept: */*
   >
   < HTTP/1.1 200 OK
   < Accept-Ranges: bytes
   < Content-Length: 11534336
   < Content-Type: application/octet-stream
   < Last-Modified: Wed, 30 Jun 2021 08:18:02 GMT
   < Date: Wed, 30 Jun 2021 09:22:41 GMT
   <
   ----snipped----
   <Response Body>
   

   En el ejemplo anterior, puedes ver que Content-Length: 11534336 (which is ~11 MB), que es la causa de este error, ya que supera el límite permitido en Apigee Edge.

Resolución

Consulta Resolución.

Causa: El tamaño de la carga útil de la respuesta supera el límite permitido después de la descompresión.

Si la carga útil de respuesta se envía en formato comprimido y el encabezado de respuesta Content-Encoding se establece en gzip, Apigee descomprime la carga útil de respuesta. Durante el proceso de descompresión, si Apigee descubre que el tamaño de la carga útil es mayor que el límite permitido en Apigee Edge, detiene la descompresión adicional y responde de inmediato con 502 Bad Gateway y el código de error protocol.http.TooBigBody.

Diagnóstico

1. Determina el código con fallas, la fuente de errores y el tamaño de la carga útil de respuesta del error observado con la supervisión de la API, la herramienta de seguimiento o los registros de NGINX Access, como se explica en Pasos comunes del diagnóstico en la situación 2.
2. Si Fuente de errores tiene el valor target, esto indica que el tamaño de la carga útil de la respuesta que envió la aplicación de destino o backend a Apigee es mayor que el límite permitido en Apigee Edge.
3. Verifica el Tamaño de la carga útil de la respuesta según lo determinado en el paso 1.
   • Si el tamaño de la carga útil supera el límite permitido de 10 MB, esa es la causa del error.
   • Si el límite permitido de tamaño de la carga útil es de aproximadamente 10 MB, es posible que la carga útil de respuesta se pase en formato comprimido. En este caso, comprueba el tamaño sin comprimir de la carga útil de respuesta comprimida.
4. Puedes validar si la respuesta del destino o backend se envió en formato comprimido y el tamaño sin comprimir era mayor que el límite permitido mediante uno de los siguientes métodos:

   Trace

   Con la herramienta Trace:

   1. Si capturaste un seguimiento para la solicitud con errores, consulta los pasos que se detallan en Seguimiento y
      1. Determinar el valor de target.received.content.length
      2. Verifica si la solicitud del cliente contenía el encabezado Content-Encoding: gzip .
   2. Si el valor de target.received.content.length está alrededor del límite permitido de 10 MB y el encabezado de respuesta Content-Encoding: gzip, esa es la causa de este error.

   Solicitud real

   Usa solicitudes reales:

   1. Si no tienes acceso a la solicitud real realizada al servidor de destino o backend, ve a Resolución.
   2. Si tienes acceso a la solicitud real realizada al servidor de destino o backend, realiza los siguientes pasos:
      1. Verifica el tamaño de la carga útil que se pasó en la respuesta junto con el encabezado Content-Encoding enviado en la respuesta.
      2. Si descubres que el encabezado de respuesta Content-Encoding está configurado como gzip y el tamaño de la carga útil sin comprimir supera el límite permitido en Apigee Edge, esa es la causa del error.

         Respuesta de muestra recibida del servidor de backend:

         curl -v https://BACKENDSERVER-HOSTNAME/testzippedfile.gz
         

         * About to connect() to 10.1.0.10 port 9000 (#0)
         *   Trying 10.1.0.10...
         * Connected to 10.1.0.10 (10.1.0.10) port 9000 (#0)
         > GET /testzippedfile.gz HTTP/1.1
         > User-Agent: curl/7.29.0
         > Host: 10.1.0.10:9000
         > Accept: */*
         >
         < HTTP/1.1 200 OK
         < Accept-Ranges: bytes
         < Content-Encoding: gzip
         < Content-Type: application/x-gzip
         < Last-Modified: Wed, 30 Jun 2021 08:18:02 GMT
         < Testheader: test
         < Date: Wed, 07 Jul 2021 10:14:16 GMT
         < Transfer-Encoding: chunked
         <
         ----snipped----
         <Response Body>
         

         En el caso anterior, se envía el encabezado Content-Encoding: gzip, y el tamaño del archivo testzippedfile.gz en la respuesta es menor que el límite. Sin embargo, el tamaño del archivo sin comprimir testzippedfile era de aproximadamente 15 MB.

   Registros de Message Processor

   Usa registros de Message Processor:

   1. Si eres un usuario de la nube privada, puedes usar los registros de Message Processor para determinar la información clave de los errores HTTP 502.

   2. Verifica los registros de Message Processor

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

   3. Busca para ver si hay errores 502 durante un período específico (si el problema ocurrió en el pasado) o si hay alguna solicitud que aún falla con 502. Puedes usar las siguientes strings de búsqueda:

      grep -ri "chunkCount"
      

      grep -ri "BadGateway: Body buffer overflow"
      

   4. Encontrarás líneas de system.log similares a las que se muestran a continuación (TotalRead y chunkCount pueden variar en tu caso):

      2021-07-07 09:40:47,012  NIOThread@7 ERROR HTTP.SERVICE -
      TrackingInputChannel.checkMessageBodyTooLarge() : Message is too large.
      TotalRead 10489856 chunkCount 2571
      
      2021-07-07 09:40:47,012  NIOThread@7 ERROR HTTP.CLIENT -
      HTTPClient$Context.onInputException() :
      ClientInputChannel(ClientChannel[Connected:
      Remote:10.148.0.10:9000 Local:10.148.0.9:42240]@9155
      useCount=1 bytesRead=0 bytesWritten=182 age=23ms  lastIO=0ms
      isOpen=true).onExceptionRead exception: {}
      com.apigee.errors.http.server.BadGateway: Body buffer overflow
      
      2021-07-07 09:40:47,012  NIOThread@7 ERROR
      ADAPTORS.HTTP.FLOW - AbstractResponseListener.onException() :
      AbstractResponseListener.onError(HTTPResponse@77cbd7c4,
      Body buffer overflow)
      

   5. Durante el proceso de descompresión, tan pronto como Message Processor determina que el total de bytes de lectura es superior a 10 MB, se detiene y se imprime la siguiente línea:

      Message is too large. TotalRead 10489856 chunkCount 2571

      Implica que el tamaño de carga útil de la respuesta es superior a 10 MB y Apigee arroja el error cuando el tamaño comienza a superar el límite de 10 MB con el código de falla como protocol.http.TooBigBody.

Resolución

Límites

Apigee espera que la aplicación cliente y el servidor de backend no envíen tamaños de carga útil mayores que el límite permitido, como se documenta para Request/response size en Límites de Apigee Edge.

1. Si eres un usuario de la nube pública, el límite máximo de tamaño de la carga útil de solicitudes y respuestas es el que se documenta para Request/response size en Límites de Apigee Edge.
2. Si eres un usuario de la nube privada, es posible que hayas modificado el límite máximo predeterminado para el tamaño de la carga útil de solicitudes y respuestas (aunque no sea una práctica recomendada). Para determinar el límite máximo de tamaño de la carga útil de la solicitud, sigue las instrucciones que se indican en Cómo verificar el límite actual.

¿Cómo puedo verificar el límite actual?

En esta sección, se explica cómo verificar que la propiedad HTTPResponse.body.buffer.limit se haya actualizado con un valor nuevo en Message Processor.

1. En la máquina del procesador de mensajes, busca la propiedad HTTPResponse.body.buffer.limit en el directorio /opt/apigee/edge-message- processor/conf y verifica qué valor se configuró como se muestra a continuación:

   grep -ri "HTTPResponse.body.buffer.limit" /opt/apigee/edge-message-processor/conf
   

2. El resultado de muestra del comando anterior es el siguiente:

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPResponse.body.buffer.limit=10m
   

3. En el resultado de ejemplo anterior, observa que la propiedad HTTPResponse.body.buffer.limit se configuró con el valor 10m en http.properties.

   Esto indica que el límite del tamaño de la carga útil de la solicitud configurada en Apigee para la nube privada es de 10 MB.

Si aún necesitas asistencia de la asistencia de Apigee, ve a Se debe recopilar información de diagnóstico.

Se debe recopilar información de diagnóstico

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 el error 502
• Archivo de seguimiento para las solicitudes a la API
• Resultado completo de la respuesta desde el servidor de destino/backend junto con el tamaño de la carga útil

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

• Mensaje de error completo observado para las solicitudes con errores
• Nombre de la organización
• Nombre del entorno
• Paquete de proxy de API
• Archivo de seguimiento de las solicitudes a la API fallidas
• Completa el comando curl que se usa para reproducir el error 502
• Resultado completo de la respuesta desde el servidor de destino/backend junto con el tamaño de la carga útil

• 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