En esta página, se muestra cómo resolver problemas relacionados con la separación de la carga útil.
Errores de código de estado HTTP
Cuando se usa la separación de la carga útil, pueden ocurrir errores comunes de código de estado HTTP.
Puedes supervisar los errores con la métrica push_request_count.
Solicitud incorrecta 400
El siguiente error se produce cuando Pub/Sub no puede procesar la solicitud debido a una configuración incorrecta o a datos faltantes.
400 Bad Request
Este error se produce por varios motivos. Estas son algunas de las causas más comunes del 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 de mensajes). Asegúrate de que coincida con el formato de solicitud esperado que especifica el extremo HTTP.
- Comprueba que la solicitud contenga los encabezados requeridos. Si faltan encabezados, es posible que debas agregarlos en los atributos del mensaje. Un ejemplo puede 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 DLQ si ves una pequeña cantidad de errores 400 que quieres inspeccionar.
401 no autorizado / 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 ocurre porque la suscripción de envío no está autenticada.
Para resolver este problema, prueba con las siguientes soluciones:
Habilita la autenticación de envío. El uso de la autenticación push es importante si realizas la integración en Cloud Run o App Engine.
Si la autenticación de envío no funciona con tu solución, es posible que debas agregar tu propia clave de autorización o clave de API en los atributos de publicación de mensajes.
415 Unsupported Media Type
El siguiente error ocurre cuando Pub/Sub no puede procesar la solicitud porque el formato de la carga útil está en un formato no compatible.
415 Unsupported Media Type
Este error se produce por varios motivos. Estas son algunas de las causas más comunes del 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, la separación de la carga útil no establece un encabezado de tipo de medio. Para establecer un encabezadoContent-Type, puedes adjuntarlo como un atributo de publicación de mensaje.
Campos de encabezado de solicitud 431 demasiado grandes / contenido demasiado grande 413
El siguiente error ocurre cuando Pub/Sub no puede procesar la solicitud porque el contenido enviado en la solicitud es demasiado grande.
431 request header fields too Large / 413 content too large
Este error ocurre si los atributos de un mensaje de Pub/Sub superan el tamaño límite de 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 otro tema para analizarlos en detalle.
Verifica si está habilitado el desenvolvimiento de la carga útil
En la consola de Google Cloud, ve a la página Suscripciones.
Haz clic en el nombre de tu servicio.
Se abrirá la página de detalles del servicio.
En la tabla de configuración, busca los siguientes valores: Mensaje de desenvolvimiento de datos y Escribir metadatos del mensaje.
El estado de unión de la carga útil (habilitada o inhabilitada) se muestra en la fila correspondiente de la tabla.
¿Qué sigue?
- Si aún tienes problemas con la separación de la carga útil, consulta Obtén asistencia.