La siguiente sección contiene información sobre resolución de problemas cuando se utiliza el servicio de mensajería web.
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:
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:
|
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:
|
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. |