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. Las siguientes 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 del mensaje). 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 los encabezados, quizás debas agregarlos en los atributos del mensaje. Un ejemplo puede incluir
Content-Type, pero otros también pueden ser necesarios. - 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 deseas inspeccionar.
Errores 401 sin autorización / prohibidos: 403
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 de envío. El uso de la autenticación push es importante si te integras 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 mensaje de publicación.
415 Unsupported Media Type
El siguiente error ocurre 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 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. Puedes establecer un encabezadoContent-Typesi lo adjuntas como un atributo de mensaje de publicación.
Campos del encabezado de la solicitud 431 demasiado grandes / contenido demasiado grande
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 se produce si los atributos de un mensaje de Pub/Sub superan el tamaño del 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. Después, tu suscripción seguirá funcionando, pero los mensajes con errores se redireccionarán a un tema independiente para un análisis más detallado.
Comprueba si la separación de la carga útil está habilitada
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: Message data unwrapping y Write message metadata.
El estado de la unión de la carga útil (habilitada o inhabilitada) se muestra en la fila de la tabla correspondiente.
¿Qué sigue?
- Si aún tienes problemas con la separación de la carga útil, consulta Obtén asistencia.