En esta página, se muestra cómo resolver problemas con el desenvolvimiento 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 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. Los siguientes son algunos de los causas comunes del error:
- La carga útil (datos del mensaje) no coincide con el formato de solicitud esperado que se especificó. por 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 requeridos. Si faltan los encabezados, es posible que debas agregarlos en los atributos del mensaje. Un ejemplo puede incluir
Content-Type
, pero es posible que también se necesiten 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.
Errores 401 sin autorización / prohibidos: 403
El siguiente error ocurre 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 autentica la suscripción push.
Para resolver este problema, prueba con las siguientes soluciones:
Habilita la autenticación push. Usar la autenticación push es importante si realizas integraciones 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 del error:
- Al extremo le falta el encabezado de tipo de contenido multimedia obligatorio.
Para resolver este problema, prueba la siguiente solución:
- Es probable que tu extremo requiera un encabezado
Content-Type
. De forma predeterminada, el desenmarañamiento de la carga útil no establece un encabezado de tipo de contenido multimedia. Tú Puedes establecer un encabezadoContent-Type
si lo adjuntas como un atributo de mensaje de publicación.
Campos de encabezado de la solicitud demasiado grandes [431 Request Header Fields Too Large] / Contenido demasiado grande [413 Content Too Large]
El siguiente error ocurre cuando Pub/Sub no puede procesar la solicitud porque el contenido que se envió 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 tamaño límite 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 push. Esto redirecciona los mensajes individuales que no se pueden entregado. Después, tu suscripción seguirá funcionando, pero los mensajes con errores se redireccionan a un tema independiente para su posterior análisis.
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 (Datos de mensajes) desenvolvimiento y escribe los metadatos del mensaje.
El estado del unión de cargas útiles (habilitado o inhabilitado) 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.