Soluciona problemas de separación de la carga útil

En esta página, se muestra cómo resolver problemas con el desempaquetado de cargas útiles.

Errores de código de estado HTTP

Cuando se usa el desempaquetado de cargas útiles, pueden producirse errores comunes de códigos de estado HTTP. Puedes supervisar los errores con la métrica push_request_count.

400, solicitud incorrecta

El siguiente error ocurre cuando Pub/Sub no puede procesar la solicitud debido a una configuración incorrecta o a la falta de datos. 

400 Bad Request

Este error se produce por varios motivos. Las siguientes son algunas de las causas más comunes de este error:

  • La carga útil (datos del mensaje) no coincide con el formato de solicitud esperado que especifica el extremo HTTP.
  • Faltan los encabezados necesarios para procesar la solicitud.
  • Se configuró un extremo HTTP incorrecto para la suscripción.

Para resolver este problema, prueba con las siguientes soluciones:

  • Verifica el formato de tu carga útil (datos del mensaje). Asegúrate de que coincida con el formato de solicitud esperado que especifica el extremo HTTP.
  • Verifica que la solicitud contenga los encabezados obligatorios. Si faltan los encabezados, es posible que debas agregarlos en los atributos del mensaje. Por ejemplo, es posible que debas incluir Content-Type, pero también pueden ser necesarios otros.
  • Confirma que el extremo HTTP configurado para tu suscripción sea válido.
  • Habilita la cola de mensajes no entregados (DLQ) en tu suscripción de envío. Esto redirecciona los mensajes individuales que no se pueden entregar. Es útil habilitar la DLQ si ves una pequeña cantidad de errores 400 que deseas inspeccionar.

401 (sin autorización) o 403 (prohibido)

El siguiente error se produce cuando Pub/Sub no puede procesar la solicitud debido a credenciales incorrectas o no válidas.

401 unauthorized / 403 forbidden

Este error se produce porque no se autenticó la suscripción de envío.

Para resolver este problema, prueba con las siguientes soluciones:

  • Habilita la autenticación push. Usar la autenticación push es importante si realizas la integración con Cloud Run o App Engine.

    Si la autenticación push no funciona con tu solución, es posible que debas agregar tu propia clave de autorización o clave de API en los atributos del mensaje de publicación.

415 Unsupported Media Type

El siguiente error se produce cuando Pub/Sub no puede procesar la solicitud porque el formato de la carga útil no es compatible.

415 Unsupported Media Type

Este error se produce por varios motivos. Las siguientes son algunas de las causas más comunes de este error:

  • Falta el encabezado de tipo de medio obligatorio en el extremo.

Para resolver este problema, prueba la siguiente solución:

  • Es probable que tu extremo requiera un encabezado Content-Type. De forma predeterminada, el desempaquetado de la carga útil no establece un encabezado de tipo de medio. Puedes configurar un encabezado Content-Type adjuntándolo como un atributo de mensaje de publicación.

431 campos de encabezado de la solicitud demasiado grandes / 413 contenido demasiado grande

Se produce el siguiente error cuando Pub/Sub no puede procesar la solicitud porque el contenido enviado en ella es demasiado grande.

431 request header fields too Large / 413 content too large

Este error se produce si los atributos de un mensaje de Pub/Sub superan el límite de tamaño del encabezado de un servidor.

Para resolver estos problemas, prueba las siguientes soluciones:

  • Desactiva Escribir metadatos.
  • Habilita la cola de mensajes no entregados (DLQ) en tu suscripción de envío. Esto redirecciona los mensajes individuales que no se pueden entregar. Luego, tu suscripción seguirá funcionando, pero los mensajes con errores se redireccionarán a un tema aparte para su análisis posterior.

Verifica si la separación de la carga útil está habilitada

  1. En la consola de Cloud de Confiance , ve a la página Suscripciones.

    Abrir suscripciones a Pub/Sub

  2. Haz clic en el nombre de tu servicio.

    Se abrirá la página de detalles del servicio.

  3. En la tabla de configuración, busca los siguientes valores: Desempaquetado de datos de mensajes y Escribir metadatos de mensajes.

    El estado del ajuste de la carga útil (habilitado o inhabilitado) se muestra en la fila de la tabla correspondiente.

¿Qué sigue?