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 el desenvolvimiento de la carga útil, pueden ocurrir errores comunes de códigos de estado HTTP.
Puedes supervisar los errores con la métrica push_request_count.
Solicitud incorrecta [400 Bad Request]
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 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.
- 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 push. 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 / 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 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. Para configurar un encabezadoContent-Type, adjúntalo como un atributo de publicación de mensajes.
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 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: Desenredo de datos de mensajes y Escribir metadatos de mensajes.
El estado del empaquetado de la carga útil (habilitado o inhabilitado) se muestra en la fila de la tabla correspondiente.
¿Qué sigue?
- Si los problemas persisten, consulta Obtén asistencia.