Resolución de problemas del servicio de mensajería web

La siguiente sección contiene información sobre resolución de problemas cuando se utiliza el servicio de mensajería web.


Referencia de habilitación de tiempo de ejecución

El tiempo de ejecución del servicio de mensajería web debe estar instalado y habilitado antes de instalar una aplicación habilitada para mensajería web. Si instala una aplicación habilitada para mensajería web sin haber instalado y habilitado el tiempo de ejecución, aparece el siguiente mensaje de error, junto con un error de servlet 503, cuando intenta acceder a un URI de mensajería web:

    CWPSB1701E: El servicio de mensajería web no está configurado para el siguiente URI entrante: /uri

Cuando aparece este mensaje, debe comprobar primero que el servicio de mensajería web esté instalado y habilitado. Consulte Habilitación del servicio de mensajería web para obtener más información. La instalación y la habilitación satisfactoria del servicio de mensajería web muestra los siguientes mensajes de anotaciones al iniciar el servidor:

     CWPSB1102I: El servicio de mensajería web se ha iniciado.

Si continúa apareciendo un error de configuración una vez instalado y habilitado el servicio de mensajería web, compruebe lo siguiente:

Consulta de mensajes de error de cliente

El servicio de mensajería web utiliza el protocolo Bayeux. La mayoría de los campos de mensajes de protocolo Bayeux tienen asociados un campo Boolean correcto y un campo de error. Si una operación Bayeux no es satisfactoria, el servicio de mensajería web intenta enviar información de error para ayudar a los desarrolladores de aplicaciones y los usuarios finales a determinar por qué ha fallado la operación. El formato de la serie de error de Bayeux contiene 3 argumentos separados por punto y coma. El primer argumento es un código de error que facilita la comparación. El segundo argumento es una lista separada por comas de argumentos implicados en la anomalía. El último argumento es una breve descripción del mensaje de error. A continuación, se muestran algunos mensajes de error de ejemplo:

En la tabla siguiente se muestran los mensajes de error más comunes que el servicio de mensajería web envía a los clientes Bayeux cuando falla una operación. Consulte esta tabla cuando depure anomalías de cliente. En la mayoría de los casos, consulte las anotaciones cronológicas de servidor para obtener más información cuando encuentre estos errores de cliente.

Código de error Breve descripción Argumentos Descripción
300 No coincidencia del número de versión Se han pasado las versiones mínima y máxima al servidor. El servidor no ha podido encontrar una coincidencia de versión para los campos de versión mínima y versión proporcionada por el cliente. En la mayoría de los casos, el servidor solicitará que el cliente repita el reconocimiento con un número de versión como el proporcionado por el servidor en los campos version y minimumVersion.
301 No coincidencia del tipo de conexión Los tipos de conexión proporcionados por el cliente. El cliente ha intentado un reconocimiento o una conexión con un tipo de conexión que no está soportado por el servidor. La respuesta de reconocimiento contendrá una lista de los tipos de conexión soportados. Si este mensaje de error se recibe durante una petición de reconocimiento, el cliente debe intentar volver a conectarse con un valor válido de la lista de tipos de conexión soportados. Si este error se recibe como respuesta a una petición de conexión, el servidor dirigirá el cliente para que repita el reconocimiento y aceptará un tipo de conexión común.
302 No coincidencia de extensión La extensión proporcionada. El protocolo Bayeux proporciona un mecanismo de extensión para habilitar funciones por encima de las que soporta el protocolo. En algunos casos, puede proporcionarse una extensión que no sea válida. En este release, el servidor ignorará las extensiones no reconocidas.
400 El servidor no ha podido reconocer la petición. none El cliente ha enviado una petición que no ha reconocido el servidor. Puede recibir este mensaje de error por los motivos siguientes:
  • El cliente ha enviado una petición que contiene un formato JSON no válido.
  • La petición JSON no se ha enviado como campo de mensaje en una petición de envío de codificación de formulario.
401 El ID de cliente especificado es desconocido. El ID de cliente que se ha especificado. Este mensaje se proporciona cuando el servidor no reconoce el ID de cliente. En la mayoría de los casos, este mensaje de error irá acompañado de un mecanismo de aviso de Bayeux que indica al cliente que debe repetir el reconocimiento y volver a suscribirse a los temas anteriores a los que estuviera suscrito. Este error se produce sobre todo cuando:
  • El cliente está intentando conectarse a ciegas con un ID de cliente no válido.
  • Se ha producido una anomalía de servidor o la afinidad de sesiones ha fallado en un entorno en clúster.
  • El cliente ha intentado conectarse después de un tiempo de espera excedido de sesión Bayeux.
402 Falta un parámetro necesario en la petición. El parámetro que falta. Las disposiciones del protocolo Bayeux requieren campos para muchos mensajes Bayeux. Si falta un campo necesario, se genera un mensaje de error indicando qué campo falta.
403 El canal especificado está prohibido. El canal que está prohibido. Si un cliente ha intentado suscribir o publicar en un canal sin los permisos de autorización adecuados, este error se devolverá al cliente.
404 El canal especificado es desconocido. El canal desconocido. El cliente ha intentado realizar una suscripción, anular una suscripción o publicar en un canal desconocido. Este error se genera sobre todo cuando se ha especificado un formato de canal multipleDestination y el primer argumento no coincide con un espacio de temas o un alias de espacio de temas de bus de integración de servicios existente.
405 La sintaxis de canal especificada no es válida. El formato de canal no válido. Este mensaje se proporciona cuando se especifica un formato de canal no válido. Consulte el protocolo Bayeux para obtener más información sobre los formatos de canal Bayeux válidos.
406 El campo de extensión especificado no es válido. El campo de extensión no válido. Este mensaje se proporciona cuando se proporciona un campo de extensión no válido. La implementación del servicio de mensajería web ignora los campos de extensión proporcionados que no reconoce, por lo que este mensaje de error no deben verlo los clientes.
407 La petición de publicación ha fallado. El canal en el que se ha emitido esta petición de publicación. Este mensaje de error indica que la petición de publicación ha fallado. En la mayoría de los casos, indica que la opción clientCanPublish se ha establecido en false.
408 El cliente no tiene autorización para conectarse para recibir o publicar mensajes. none Este mensaje de error se proporciona durante una petición de reconocimiento o conexión. En la mayoría de los casos, este mensaje de error indica un problema con la configuración de la seguridad del bus de integración de servicios, en concreto, al otorgar el rol de conector de bus para este usuario entrante.
500 El servidor ha encontrado un error interno y no ha podido completar la petición. none Se ha encontrado un error de servidor interno. Consulte las anotaciones cronológicas de servidor para obtener más información.
503 Servicio no disponible. none Se ha detectado un error al comunicarse con un bus de integración de servicios. Esto normalmente ocurre cuando se produce una anomalía en la comunicación con un motor de mensajería, como el motor de mensajería que se está deteniendo. Consulte las anotaciones cronológicas de servidor para obtener más información.


Condiciones de uso | Comentarios