Error 400 de solicitud incorrecta: DuplicateHeader

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 400 Bad Request con el código de error protocol.http.DuplicateHeader 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 400 Bad Request

Además, es posible que veas un mensaje de error similar al que se muestra a continuación:

{
   "fault":{
      "faultstring":"Duplicate Header \"Expires\"",
      "detail":{
         "errorcode":"protocol.http.DuplicateHeader"
      }
   }
}

Causas posibles

Este error ocurre si un 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 solicitud HTTP que envía el cliente a Apigee Edge.

Según RFC 7230, sección 3.2.2: Orden de campos, un remitente NO DEBE generar varios campos de encabezado con el mismo nombre de campo en un mensaje, a menos que el valor de campo completo para ese campo de encabezado esté definido como una lista. #(values)] o el campo del encabezado es una excepción conocida. Si Apigee Edge encuentra un encabezado específico que no puede tener duplicados, más de una vez en la solicitud HTTP que envía el cliente, entonces este responde con 400 Bad Request y el código de error protocol.http.DuplicateHeader.

A continuación, se muestran las posibles causas de este error:

Pasos comunes de diagnóstico

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

Causa: encabezado duplicado en la solicitud

Diagnóstico

1. Determina el código de error y la fuente de errores del error observado con la supervisión de la API o los registros de acceso de NGINX, como se explica en Pasos comunes de diagnóstico.
2. Si Fuente con errores tiene el valor apigee o MP, esto indica que la solicitud que envió la aplicación cliente a Apigee contiene encabezados duplicados.

3. Puedes determinar el encabezado real que se envía más de una vez como parte de la solicitud mediante uno de los siguientes métodos:

   Mensaje de error

   Uso del mensaje de error

   1. Si tienes acceso al mensaje de error completo que recibiste de Apigee Edge, consulta la faultstring. El faultstring contiene el nombre del encabezado que se envió más de una vez.

      Ejemplo de mensaje de error:

      "faultstring":"Duplicate Header \"Expires\""
      

   2. En el mensaje de error anterior, puedes ver que el encabezado Expires se envía más de una vez, como se ve en faultstring.

   Solicitud real

   Usa la solicitud real

   1. Si tienes acceso a la solicitud real que realizó la aplicación cliente, sigue estos pasos:

      1. Verifica la lista de encabezados pasados en la solicitud.
      2. Si descubres que un encabezado en particular aparece más de una vez en la solicitud con el mismo valor o con valores diferentes , esa es la causa del error.

      Solicitud de muestra:

      curl https://HOST_ALIAS/duplicateheadertest -v -H "Expires: Mon, 21 June 2021 07:28:00 GMT" -H "Expires: Mon, 21 June 2021 07:28:00 GMT"
      

      En la solicitud de ejemplo anterior, el encabezado Expires se envía más de una vez. Por lo tanto, esta solicitud falla con el error 400 Bad Request y el código de error protocol.http.DuplicateHeader.

   2. Como alternativa, si tienes acceso a los registros del cliente, puedes ver si tienes información sobre la solicitud real realizada a Apigee Edge y determinar el encabezado que se envía más de una vez.

Resolución

HTTPHeader.Expires=allowDuplicates, multiValued

Especificación

Apigee espera que la aplicación cliente no envíe encabezados duplicados como parte de la solicitud de acuerdo con las siguientes especificaciones de RFC:

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

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 400.
• 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
• Completa el comando curl que usaste para reproducir el error 400.
• 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